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内 容 提 要 


Big Nerd Ranch 是 美国 一 家 专业 的 移动 开发 技术 培训 机 构 。 本 书 主 要 以 其 Android 训练 营 教 学 课程 为 
基础 ， 融 合 了 儿 位 作者 多 年 的 心得 体会 ， 是 一 本 完全 面向 实战 的 Android 编程 权威 指南 。 全 书 共 36 章 ， 详 


细 介 绍 了 8 个 Android 应 月 

















有 的 开发 过 程 。 通 过 这 些 精 心 设计 的 应 用 ， 读 者 可 掌握 很 多 重要 的 理论 知识 和 开 





发 技巧 ， 获 得 宝贵 的 开发 经 验 。 
第 3 版 较 之 前 版 本 增加 了 对 数据 绑 定 等 新 工具 的 介绍 ， 同 时 新 增 了 针对 单元 测试 、 辅 助 功能 和 
MVVM 架构 等 主题 的 音节。 如 果 你 熟悉 Java 语言 ， 或 者 了 解 面向 对 象 编程 ， 那 就 立刻 开始 Android 编程 





之 旅 吧 ! 
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献 词 


献 给 我 桌 上 的 唱片 机 。 感 谢 你 联 伴 我 完成 本 书 。 我 保证 ， 很 快 你 就 会 有 新 喝 针 了 。 


一 -一 B.P. 
献 给 我 的 爸爸 David， 他 教 我 懂得 辛苦 工作 的 意义 。 献 给 我 的 妈妈 Lisa， 她 一 直 督 促 我 去 做 正 
确 的 事 。 
一 -一 人 C.9. 
献 给 我 的 爸爸 Dave Vadas， 他 激励 并 支持 我 投身 计算 机 行业 。 献 给 我 的 妈妈 Joan Vadas， 在 


么 多 年 的 浮 浮沉 沉 里 ， 她 总 能 让 我 保持 乐观 。 ( 她 会 给 我 支 招 : 0 《黄金 
es ) 


——K.M. 


致谢 











这 是 本 书 第 3 版 。 我 们 常 说 ， 当 然 ， 也 应 再 三 强调 : 仅 任 作者 是 无 法 成 书 的 。 这 背后 是 团队 

的 力量 : 合作 者 、 责 任 编辑 和 支持 者 。 没 有 他 们 ， 想 抓 住 重点 并 撰写 出 这 么 多 的 出 版 素材 肯定 

不 可 能 。 

口 Brian Hardy 和 Bill 很 有 雄心 ， 他 们 从 无 到 有 ， 写 出 了 本 书 第 1 版 。 真 了 不 起 。 

口 感谢 我 们 Android 开 发 团队 的 同事 Andrew Lunsford、 Bolot Kerimbaev、Brian Gardner、 David 
Greenhalgh 、Josh Skeen、Matt Compton 、Paul Turner 和 Rashad Cureton。 他 们 一 直 用 这 些 
还 不 够 完善 的 材料 教学 ， 并 提出 了 不 少 宝贵 建议 ， 也 修改 了 一 些 错误 。 能 和 这 样 有 趣 、 
有 才 的 团队 一 起 工作 ， 此 生 无 憾 。 在 Big Nerd Ranch 工 作 的 日 子 ， 每 一 天 都 是 享受 。 

口 特别 感谢 Andrew。 他 为 本 书 同步 更 新 了 一 大 批 Android Studio 截 图 。 他 很 细心 ， 不 放 过 任 

何 细节 ， 说 话 还 幽默 辛辣 ， 令 人 欣赏 。 

口 Zack Simon， 说 起 话 来 轻声 细 语 ， 是 我 们 Big Nerd Ranch 了 不 起 的 天 才 设 计 师 。 他 不 声 不 
响 地 更 新 了 附 在 书后 的 Android 开 发 速 查 表 ， 给 了 我 们 一 个 大 大 的 惊喜 。Zack， 谢 谢 你 ! 
如 果 速 查 表 用 着 不 错 ， 你 也 去 谢谢 他 吧 ! 

口 感谢 Kar Loong Wong， 他 重新 设计 了 crime 应 用 列表 屏 。 只 要 他 多 伸手 ， 本 书 的 应 用 肯定 

会 越 来 越 好 看 。 

口 感谢 Mark Dalrymple ， 他 审阅 了 constraint layout 这 部 分 内 容 ， 使 之 更 加 准确 、 完 善 。 凑 巧 

磁 到 他 的 话 ， 如 果 你 也 在 搞 constraint layout， 千 万 记得 请 他 把 关 ， 他 可 是 这 方面 的 专家 。 
不 搞 也 没关系 ， 可 以 请 多 才 多 艺 的 他 扎 些 气 球 小 动物 玩 玩 。 

口 感谢 Aaron Hillegass。 他 若 不 创建 Big Nerd Ranch 公 司 ， 这 一 切 都 无 从 谈 起 。 

口 感谢 我 们 的 编辑 Elizabeth Holaday。 据 说 ， 著 名 的 “ 垮 掉 的 一 代 ” 文 学 作家 William S. 
Burroughs 有 时 会 把 自己 的 作品 分 成 多 个 部 分 ， 抛 向 空中 ， 然 后 以 稿件 的 落地 顺序 出 书 。 
要 不 是 Liz， 在 遇 到 困惑 、 一 时 冲动 时 ， 相 信 我 们 也 会 这 么 做 。 在 她 的 指导 下 ， 我 们 才能 
有 的 放 矢 ， 写 出 清晰 、 简 洁 的 书稿 。 

D 感谢 Ellie Volckhausen 为 本 书 设计 了 封面 。 

感谢 我 们 的 文字 编辑 Anna Bentley 和 审 稿 编辑 Simone Payment。 感 谢 她 俩 的 打磨 完善 。 

口 感谢 IntelligentEnglish.com 网 站 的 Chris Loper。 他 设计 并 制作 了 本 书 的 纸 质 版 和 电子 版 。 
他 的 DocBook 工 具 简 直 太 好 用 了 。 
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2 致 谢 





最 后 感谢 我 们 的 学 员 。 我 们 之 间 有 个 反馈 环 : 我 们 以 本 书 内 容 教学 ， 他 们 不 断 给 予 反馈 。 没 
有 这 个 反馈 环 ， 就 没有 这 本 书 ， 即 便 有 ， 也 不 会 越 来 越 完 善 。 如 果 说 Big Nerd Ranch 公 司 的 图 书 
够 特别 (希望 如 此 )， 功 劳 就 在 于 这 个 反馈 环 。 再 次 感谢 。 





























如 何 学 习 Android 开 发 

















学 习 Android 开 发 ， 对 每 个 新 手 都 是 一 个 很 大 的 挑 成 ， 就 好 像 在 异国 他 乡 学 会 生存 一 样 。 即 
使 会 说 当地 的 语言 ,一 开始 也 绝 不 会 有 在 家 的 感觉 , 因为 你 不 能 完全 理解 周围 的 人 所 理解 的 东西 。 
原 有 的 知识 储备 在 新 环境 下 可 能 完全 派 不 上 用 场 。 

Android 有 自己 的 语言 文化 一 一 使 用 Java 语 言 。 但 仅 掌握 Java 远 远 不 够 ， 还 需要 通过 学 习 很 多 
新 的 理论 和 技术 知识 来 理 清 头 绪 ， 从 而 指引 你 穿越 陌生 的 领域 。 

该 我 们 登场 了 。 在 Big Nerd Ranch， 我 们 认为 ， 要 成 为 Android 开 发 人 员 ， 必 须 做 到 ; 

口 着 手 开发 一 些 Android 应 用 ; 
口 彻底 理解 你 的 Android 应 用 。 

本 书 将 协助 你 完成 以 上 两 件 事情 。 我 们 已 用 它 成 功 培 训 了 数 千 名 专业 的 Android 开 发 人 员 。 
本 书 将 指导 你 完成 多 个 Android 应 用 的 开发 ， 并 根据 需要 逐步 介绍 各 种 理论 概念 及 技术 知识 。 在 
学 习 过 程 中 ， 如 果 遇 到 知识 疑难 点 ， 请 勇敢 面 对 ; 我 们 也 会 尽 最 大 努力 抽 丝 剥 草 ， 让 你 知 其 然 更 
知 其 所 以 然 。 

我 们 的 教学 方法 是 : 在 学 习 理 论 的 同时 , 就 着 手 运 用 它们 开发 实际 的 应 用 ,而 非 先 学 习 一 大 
堆 理论 ， 再 考虑 如 何 将 理论 应 用 于 实践 。 读 完 本 书 , 你 将 具备 必要 的 开发 经 验 及 知识 。 以 此 为 起 
点 ， 深 入 学 习 ， 逐 渐 成 长 为 一 名 合格 的 Android 开 发 者 。 
























































阅读 前 提 
使 用 本 书 ， 你 需要 熟悉 Java 语 言 ， 包 括 类 、 对 象 、 接 口 、 监 听 器 、 包 、 内 部 类 、 匿 名 内 部 类 、 
泛 型 类 等 基本 概念 。 
如 果 不 熟 悉 这 些 概念 , 很 可 能 刚 翻 几 页 就 已 无 法 继续 下 去 。 对 此 , 建议 先 放 下 本 书 , 找 本 Java 
人 入门 书 看 一 看 。 市面 上 有 很 多 优秀 的 Java 入 门 书 , 你 可 以 基于 自己 的 编程 经 验 及 学 习 风 格 去 挑选 。 
如 果 你 熟悉 面向 对 象 编程 ， 但 Java 知 识 忘 得 差不多 了 ， 阅 读本 书 应 该 不 会 有 太 大 的 问题 。 对 
于 接口 、 匿 名 内 部 类 等 重要 的 Java 语 言 点 ， 我 们 会 提供 必要 的 简短 回顾 。 建 议 在 学 习 过 程 中 手边 
备 上 一 本 Java 参 考 书 ， 方 便 查 阅 。 


第 3 版 有 哪些 新 内 容 


本 书 第 3 版 介绍 了 一 些 新 工具 : constraintlayout ( 包括 其 编辑 器 ) 和 数据 绑 定 ( data binding )。 





















































2 如 何 学 习 Android 开发 





新 增加 了 几 个 章节 ， 内 容 涉及 单元 测试 、 辅 助 功 能 ( accessibility )、MVVM 架 构 和 应 用 本 地 化 。 
本 书 末尾 还 介绍 了 Android 的 新 运行 时 权限 系统 。 此 外 ， 我 们 还 进一步 扩充 了 挑战 练习 和 深入 学 
习 部 分 的 内 容 ， 并 修订 了 全 书 的 一 些 不 够 完善 的 部 分 。 


如 何 使 用 本 书 


本 书 基于 Big Nerd Ranch 培 训 机 构 的 $ 天 教学 课程 编写 而 成 。 课 程 从 基础 知识 讲 起 ,各 章节 内 
容 以 循序 渐进 的 方式 编排 ,建议 不 要 跳 读 ， 以 免 学 习 效 果 大 打折 扣 。 显 然 ， 本 书 不 适合 作为 参考 
书 。 本 书 则 在 帮 你 跨越 学 习 的 初始 障碍 , 进而 充分 利用 其 他 各 种 参考 资料 和 代码 实例 类 图 书 来 深 
入 学 习 。 

我 们 为 学 员 提 供 了 和 良好 的 培训 环境 : 专门 的 培训 教室 、 可 口 的 美食 、 舒 适 的 住宿 条 件 、 动 力 
十 足 的 学 习 伙 伴 ， 以 及 随时 答疑 解 惑 的 指导 老师 。 

你 同样 需要 类 似 的 良好 环境 。 因此， 应 保证 充足 的 睡眠 ， 找 一 个 安静 的 地 方 开 始 学 习 。 参 考 
以 下 建议 也 很 有 帮助 : 

(1) 组 织 朋 友 或 同事 组 成 兴趣 小 组 学 习 ; 

(2) 集中 安排 时 间 逐 章 学 习 ; 

(3) 参与 本 书 论坛 的 交流 讨论 ( forums.bignerdranch.com ); 

(4) 寻求 Android 开 发 高 手 的 帮助 。 


本 书 内 容 


本 书 带 你 学 习 开 发 8 个 Android 应 用 。 有 些 应 用 很 简单 ， 一 章 即 可 讲 完 ; 有 些 则 相对 复杂 。 最 
复杂 的 一 个 应 用 监 越 了 13 章 。 通过 这 些 精心 编排 的 应 用 , 你 能 学 到 很 多 重要 的 理论 知识 和 开发 技 
巧 ， 并 获得 最 直接 的 开发 经 验 。 

D GeoQuiz 

本 书 的 第 一 个 应 用 , 借 此 学 习 Android 应 用 的 基本 组 成 、activity、 界面 布局 以 及 显 式 intent。 

口 CriminalIntent 
本 书 中 最 复杂 的 应 用 ， 用 来 记录 办 公 室 同 事 的 种 种 陋习 。 借 此 应 用 学 习 fragment、 主 从 用 
户 界面 、list-backed 用 户 界面 、 菜 单 选项 、 相 机 调用 、 隐 式 intent 等 内 容 。 

口 BeatBox 
一 个 可 以 震慑 坏人 的 应 用 , 借 此 深入 学 习 fragment、 媒体 文件 的 播放 与 控制 .MVVM 架 构 、 
数据 绑 定 、 单 元 测试 、 主 题 以 及 drawable 资 源 。 

口 NerdLauncher 

一 个 个 性 化 启动 器 ， 借 此 深入 学 习 intent 以 及 Android 任 务 。 

口 PhotoGallery 
一 个 从 Flickr 网 站 下 载 并 显示 照片 的 客户 端 应 用 , 借 此 学 习 Android 服 务 、 多 线程 、 网 络 内 
容 下载 等 知识 。 
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口 DragAndDraw 

一 个 简单 的 画图 应 用 ， 借 此 学 习 触摸 手势 事件 处 理 以 及 如 何 创 建 个 性 化 视图 。 

口 Sunset 

一 个 漂亮 的 日 落 动 画 应 用 ， 借 此 学 习 Android 动 画 。 

口 Locatr 

一 个 查询 当前 位 置 的 Flickr 图 片 并 显示 在 地 图 上 的 应 用 。 借 此 应 用 学 习 如 何 使 用 定位 服务 
和 地 图 。 


挑战 练习 


大 部 分 章 末 都 配 有 练习 题 。 可 借 此 机 会 学 以 致 用 , 查阅 官方 文档 , 锻炼 独立 解决 问题 的 能 

强烈 建议 你 完成 这 些 挑战 练习 。 在 练习 过 程 中 ， 学 试 另 辟 蹊 径 ， 探 索 自 己 独特 的 学 习 之 路 。 
这 有 助 于 巩固 所 学 知识 ， 增 强 未 来 开发 应 用 的 信心 。 

若 遇 到 一 时 难以 解决 的 问题 ， 请 访问 论坛 http:/forums.bignerdranch.com 求 助 。 















































深入 学 习 


部 分 童 末 还 包含 一 块 名 为 “深入 学 习 ” 的 内 容 。 这 些 内 容 针 对 相应 章节 的 知识 点 ， 提 供 深 
入 讲解 或 更 多 学 习 信 息 。 本 部 分 内 容 不 属于 必须 掌握 的 部 分 , 但 还 是 希望 你 有 兴趣 阅读 并 有 所 
收获 。 


编码 风格 


有 别 于 其 他 Android 开 发 学 习 社 区 的 编码 风格 ， 我们 有 自己 的 偏好 ， 主 要 有 以 下 两 个 方面 。 

口 在 监听 器 代码 部 分 使 用 匿名 内 部 类 
这 纯 属 个 人 偏好 。 我 们 认为 ,使 用 匿名 内 部 类 ， 代 码 可 以 更 简练 ， 监 听 器 实现 方法 更 一 
目 了 然 。 尽 管 在 高 性 能 要 求 的 场景 下 或 大 型 应 用 中 ， 匿 名 内 部 类 可 能 会 有 一 些 问题 ， 但 
大 多 数 情 况 下 没有 问题 。 

口 自 第 7 章 引 入 fragment 后 ， 后 续 所 有 用 户 界 面 都 使 用 它 
我 们 有 理由 坚持 这 一 点 。 相 信 我 们 ， 使 用 得 当 的 话 ，fragment 就 是 Android 开 发 人 员 手 中 
的 一 大 利器 。 一 旦 适应 ， 用 起 来 也 没 那么 难 。 相 比 activity，fragment 在 创建 和 显示 用 户 界 
面 时 更 加 灵活 ， 优 势 明显 ， 值 得 为 此 付出 努力 。 


















































版 式 说 明 
为 方便 阅读 ， 本 书 会 对 某 些 特定 内 容 采 用 专门 的 字体 。 变 量 、 常 量 、 类型、 类 名、 接口 名 和 
方法 名 会 以 代码 体 显示 。 




















所 有 代码 与 XML 清单 也 会 以 代码 体 显 示 。 需 要 输入 的 代码 或 XML 总 是 以 粗 体 显示 。 应 该 删 





4 如 何 学 习 Android 开发 





除 的 代码 或 XML 会 打上 删除 线 。 例 如 ， 在 以 下 实现 代码 里 ， 我 们 删除 了 makeText ( . . . ) 方 法 的 
调用 ， 增 加 了 checkAnswer(true) 方 法 的 调用 。 


GOverride 
public void onClick(View v) { 





Teast.LENGTH_SHORT) .shewO); 
checkAnswer (true); 


} 
Android 版 本 


本 书 教学 主要 针对 当前 广泛 使 用 的 各 个 系统 版 本 ( Android 4.4 至 Android 7.1 )。 虽 然 更 老 的 
系统 版 本 仍 有 人 在 用 , 但 对 于 大 多 数 开发 者 来 说 ,为 这 部 分 人 开发 应 用 就 是 个 赔本 的 买卖 。 如 果 
应 用 确实 需要 支持 Android 4.4 之 前 的 系统 版 本 ,请 参考 本 书 第 2 版 ( Android 4.1 及 以 上 版 本 ) 和 
第 1 版 (Android 2.3 及 以 上 版 本 ) 的 相关 内 容 。 

Google 还 会 不 断 地 发 布 新 版 本 的 Android 系 统 。 请 放心 ，Android 支 持 向 后 兼容 ( 详 见 第 6 章 )， 
即便 有 了 新 系统 ， 本 书 所 授 知 识 也 不 会 过 时 。 而 且 ， 通 过 forums.bignerdranch.com 论 坛 ， 我 们 也 
会 不 断 跟 踪 Android 开 发 新 动向 ， 及 时 为 你 提供 开发 指导 和 支持 。 












































开发 必 备 工具 

















开始 学 习 前 ， 你 需要 安装 Android Studio。 基 于 流行 的 IntelliJ IDEA 创 建 ，Android Studio 是 用 
于 Android 开 发 的 一 套 集成 开发 工具 。 
Android Studio 的 安装 包括 如 下 内 容 。 
口 Android SDK 
最 新 版 本 的 Android SDK。 
口 Android SDK 工 具 和 平台 工具 
用 来 测试 与 调试 应 用 的 一 套 工 具 。 
口 Android 模 拟 器 系统 镜像 
用 来 在 不 同 虚拟 设备 上 开发 和 测试 应 用 。 
撰写 本 书 时 ，Google 一 直 在 积极 开发 和 更 新 Android Studio 版 本 。 因 此 , 请 注意 了 解 当前 版 本 
和 本 书 所 用 版 本 之 间 的 差异 。 如 需 帮助 ， 请 访问 forums.bignerdranch.com 论 坛 。 


























Android Studio 的 下 载 与 安装 


可 以 从 Android 开 发 者 网 站 下 载 Android Studio: developer.android.com/sdk/。 
首次 安装 的 话 ， 还 需 从 www.oracle.com 下 载 并 安装 Java 开 发 工具 箱 (JDK 8 )。 
如 仍 有 疑问 ， 请 访问 网 址 developer.android.com/sdk/ 寻 求 帮助 。 





下 载 早 期 版 本 的 SDK 





Android Studio 自 带 最 新 版 本 的 SDK 和 模拟 器 系统 镜像 。 若 想 在 Android 早 期 版 本 上 测试 应 用 ， 
还 需 额 外 下 载 相关 工具 组 件 。 

可 通过 Android SDK 管 理 器 来 配置 安装 这 些 组 件 。 在 Android Studio 中 , 选择 Tools 一 Android 一 
SDK Manager 菜 单项 ， 如 图 0-1 所 示 。( 已 创建 并 打开 了 新 项 目 时 ，Tools 荣 单 才 可 见 。 还 没 创 建 过 
项 目的 话 ， 可 在 Android 开 发 向 导 界 面 ， 在 Quick Start 区 域 ， 选 择 Configure 一 SDK Manager 来 启 
动 SDK 管 理 兢 。) 

















2 开发 必 备 工具 





@ 8@ Preferences 
Q Appearance & Behavior > System Settings > Android SDK Reset 
TY Appearance & Behavior Manager for the Android SDK and Tools used by Android Studio 
Appearance Android SDK Location: /AndroidDeveloper/sdk Edit 


Menus and Toolbars SDKTools SDK Update Sites 





vw System Settings 
Each Android SDK Platform package includes the Android platform and sources pertaining to 


Passwords an APl level by default. Once installed, Android Studio will automatically check for updates. 
HTTP Proxy Check "show package details" to display individual SDK components. 
Updates | Name ApPl Level Revision | Status 
Usage Statistics Android 7.0 (Nougat) 24 2 Installed 
Android 6.0 (Marshmallow) 23 3 Not installed 
Android SDK Android 5.1 (Lollipop) 22 2 Not installed 
File Colors | Android 5.0 (Lollipop) 2 2 Not installed 
Scopes 总 Android 4.4W (KitKat Wear) 20 2 Not installed 
二 机 Android 4.4 (KitKat) 19 4 Not installed 
人 Android 4.3 (Jelly Bean) 18 3 Not installed 
Quick Lists Android 4.2 (Jelly Bean) 17 3 Not installed 
Path Variables Android 4.1 (Jelly Bean) 16 5 Not installed 
Keymap Android 4.0.3 (IceCreamSandwich) 15 5 Not installed 
Android 4.0 (IceCreamSandwich) 14 4 Not installed 
» Editor 
Show Package Details 
Plugins 





六 Version Control Launch Standalone SDK Manager 


PP NET BS ES RS SS 


学 Cancel Apply OR 
图 0-1 Andriod SDK 管 理 器 


选择 并 安装 需要 的 Android 版 本 和 工具 。 下 载 这 些 组 件 需要 一 定时 间 ， 请 耐心 等 待 。 
通过 Android SDK 管 理 器 , 还 可 以 及 时 获取 Android 最 新 发 布 内 容 ， 比 如 新 系统 平台 或 新 版 本 





硬件 设备 


模拟 器 是 测试 应 用 的 好 帮手 ， 但 需 测 试 应 用 性 能 时 ， 物 理 Android 设 备 无 可 蔡 代 。 如 果 手 头 
有 物理 设备 ， 建 议 按 需 使 用 。 
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本 章 将 带 你 开发 本 书 第 一 个 应 用 , 并 借 此 学 习 一 些 Android 基 本 概念 以 及 构成 应 用 的 UI 组 件 。 
学 完 本 章 ， 如 果 没 能 全 部 理解 ， 也 不 必 担 心 ， 后 续 章 节 还 会 涉及 这 些 内 容 并 有 更 加 详细 的 讲解 。 

马上 要 开发 的 应 用 名 叫 GeoQuiz， 它 能 给 出 一 道道 地 理 知 识 问题 。 用 户 点 击 TRUE 或 FALSE 
按钮 来 回答 屏幕 上 的 问题 ，GeoQuiz 即 时 作出 反馈 。 

1-1 显 示 了 用 户 点 击 TRUE 按钮 的 结果 。 


BA RA) 
GeoQuiz 

















Canberra is the capital of Australia. 


TRUE FALSE 


图 1-1 你 是 澳洲 人 吗 
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1.1 Android 开发 基础 


GeoQuiz 应 用 由 一 个 activity 和 一 个 布局 (layout ) 组 成 。 

口 activity 是 Android SDK 中 Activity 类 的 一 个 实例 ， 负 责 管理 用 户 与 应 用 界面 的 交互 。 
应 用 的 功能 是 通过 编写 Activity 子 类 来 实现 的 。 对 于 简单 的 应 用 来 说 , 一 个 Activity 子 
类 可 能 就 够 了 了， 而 复杂 的 应 用 则 会 有 多 个 。 
GeoQuiz 是 个 简单 应 用 ， 因 此 它 只 有 一 个 名 叫 QuizActivity 的 Activity 子 类 。 
QuizActivity 管 理 着 图 1-1 所 示 的 用 户 界面 。 

口 布局 定义 了 一 系列 用 户 界面 对 象 以 及 它们 显示 在 屏幕 上 的 位 置 。 组 成 布局 的 定义 保存 在 
XML 文件 中 。 每 个 定义 用 来 创建 屏幕 上 的 一 个 对 象 ， 如 按钮 或 文本 信息 。 
GeoQuiz 应 用 包含 一 个 名 叫 activity_quiz.xml 的 布局 文件 .该 布局 文件 中 的 XML 标签 定义 了 
图 1-1 所 示 的 用 户 界面 。 

QuizActivity 与 activity quiz.xml 文 件 的 关系 如 图 1-2 所 示 。 
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GeoQuiz 








QuizActivity > Canberrais the capital of Australia activity_quiz.xml 
TRUE FALSE 











图 1-2 QuizActivity 管 理 着 activity_quiz.xml 文 件 定义 的 用 户 界面 
有 了 这 些 Android 基 本 概念 之 后 ， 我 们 来 创建 GeoQuiz 应 用 。 








1.2 创建 Android 项 目 


首先 我 们 创建 一 个 Android 项 目 。Android 项 目 包含 组 成 一 个 应 用 的 全 部 文件 。 
启动 Android Studio 程 序 ， 首 次 运行 的 话 ， 会 看 到 如 图 1-3 所 示 的 欢迎 界面 。 











1.2 创建 Android 项 目 3 





© Welcome to Android Studio 


仿 


全 


Androld Studio 


Version 2.2 Beta 2 (Al-145.3200535) 


闪 Start a new Android Studio project 

DD Open an existing Android Studio project 
量 Check out project from Version Control ~ 
Import project (Eclipse ADT, Gradle, etc.) 


t¥ Import an Android code sample 


总 Configure ”Get Help ~ 

















图 1-3 ”欢迎 使 用 Android Studio 





在 欢迎 界面 ， 选 择 创建 Android Studio 新 项 目 选 项 ( Start a new Android Studio project ); 非 首 
次 运行 的 话 ， 选 择 File 一 New 一 New Project... 菜 单项 。 

现在 ， 你 应 该 打开 了 新 建 项 目 向 导 界 面 ， 如 图 1-4 所 示 。 在 此 界面 的 应 用 名 称 ( Application 
name ) 处 输入 GeoQuiz。 在 公司 域名 (Company Domain ) 处 输入 android.bignerdranch.com。 此 时 
自动 产生 的 包 名 称 (Package name ) 会 变 为 com.bignerdranch.android.geoquiz。 至 于 项 目 存储 位 置 


( Project location )， 就 看 个 人 喜好 了 。 


@"e9 Create New Project 


New Project 


Android Studio 





Configure your new project 


Application name: GeoQuiz 
Company Domain: android.bignerdranch.com 
Package name: com.bignerdranch.android.geoquiz Edit 


Include C++ Support 


Project location: /Users/dev/AndroidStudioProjects /GeoQuiz 


Cancel | | Provious | TI Finish 





图 1-4 ”创建 新 项 目 
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注意 ,以 上 包 名 称 遵循 了 “DNS 反 转 ”约定 ， 也 就 是 将 企业 组 织 或 公司 的 域名 反 转 后 ,在 尾 
部 附加 上 应 用 名 称 。 遵 循 此 约定 可 以 保证 包 名 称 的 唯一 性 ,， 这样， 同一 设备 和 Google Play 商店 的 
各 类 应 用 就 可 以 区 分 开 来 。 

单 击 Next 按 钮 ， 接 下 来 配置 应 用 支持 哪些 版 本 的 Android 设 备 。GeoQuiz 应 用 只 能 在 手机 上 运 
行 ， 所 以 这 里 勾 选 Phone and Tablet 选 项 。SDK 最 低 版 本 选择 API 19: Android 4.4 (KitKat)， 如 图 1-5 
所 示 。 第 6 章 会 介绍 Android 不 同 SDK 版 本 的 差异 。 


和 由 @ Create New Project 





yx Target Android Devices 





Select the form factors your app will run on 


Different platforms may require separate SDKs 


Phone and Tablet 
Minimum SDK API 19: Android 4.4 (KitKat) 5 





Lower APl levels target more devices, but have fewer features available. 


By targeting API 19 and later, your app will run on approximately 73.9% of the devices 
that are active on the Google Play Store. 


Help me choose 


Wear 
Minimum SDK API 21: Android 5.0 (Lollipop) 
TV 
Minimum SDK API 21: Android 5.0 (Lollipop) 3| 
Android Auto 
Glass 
Minimum SDK Glass Development Kit Preview (API 19) 3| 
Cancel Previous EL Finish 
» :二 
图 1-5 设备 支持 配置 
单 击 Next 按 钮 继续 。 





在 接 下 来 的 窗口 中 ， 需 要 为 GeoQuiz 应 用 的 启动 初始 屏 选择 模板 ， 如 图 1-6 所 示 。 选 择 Empty 
Activity 后 单 击 Next 按 钮 继续 。 

(Android Studio 更 新 频繁 , 因此 新 版 本 的 向 导 界 面 可 能 与 本 书 略 有 不 同 。 这 不 是 什么 大 问题 ， 
一 般 来 讲 ， 工 具 更 新 后 ,向导 界面 的 配置 选项 应 该 不 会 有 太 大 差别 。 如 果 大 有 不 同 ,， 说明 开 发 工 
具有 了 重大 更 新 。 不 要 担心 ， 请 访问 本 书 论坛 forums.bignerdranch.com， 我 们 会 教 你 如 何 使 用 新 
版 本 的 开发 工具 。) 
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© e® Create New Project 








Add No Activity 


Basic Activity 





Fullscreen Activity Google AdMob Ads Activity Google Maps Activity 


Cancel Previous | Next | Finish 


图 1-6 ”选取 activity 类 型 ( 空 activity ) 





在 应 用 向 导 的 最 后 一 个 窗口 ， 命 名 activity 子 类 为 QuizActivity， 如 图 1-7 所 示 。 注 意 子 类 名 
的 Activity 后 级。 尽管 不 是 必需 的 ， 但 最 好 是 遵循 这 种 规范 的 命名 约定 。 








Create New Project 


A Customize the Activity 


Creates a new empty activity 


Activity Name: QuizActivity 
Generate Layout File 
Layout Name: activity_quiz 


Backwards Compatibility (AppCompat) 


Empty Activity 


Cancel Previous Next “| 0 
图 1-7 配置 activity 
确认 Generate Layout File 选 项 已 勾 选 。 为 体现 布局 与 activity 间 的 对 应 关系 ， 布 局 名 ( Layout 


6 第 1 章 Android 开发 初 体验 





Name ) 会 自动 更 新 为 activity_quiz。 布局 的 命名 规则 是 ， 颠倒 activity 子 类 名 的 单词 顺序 并 全 
部 转 小 写 , 然后 在 单词 间 添 加 下 划 线 。 对 于 后 续 章 节 中 的 所 有 布局 以 及 将 要 学 习 的 其 他 资源 ， 都 
建议 采用 这 种 命名 风格 。 

如 果 你 的 Android Studio 版 本 还 有 其 他 选项 ， 请 保持 默认 选择 不 变 。 单 击 Finish 按 钮 ，Android 
Studio 会 完成 创建 并 打开 新 项 目 。 





1.3 Android Studio 使 用 导航 


如 图 1-8 所 示 ，Android Studio 已 在 工作 区 窗口 里 打开 新 建 项 目 。 
整个 工作 区 窗口 分 为 不 同 的 区 域 ， 这 里 统称 为 工具 窗口 ( tool window )。 


@@e@ QuizActivityjava - GeoQuiz - [/Users/dev/AndroidStudioProjects/GeoQuiz] - Android Studio 2.2 Beta 2 
户 避 务 和 少 光 团 明 有 各 人 中信 己 ap 了 其 示 世人 国 风 人 EDL? Q 





C3 GeoQuiz ) Ca app ) DD src ) DD main ) Djava ) 四 com ) 加 bignerdranch ) 四 android ) 加 geoquiz ) (© QuizActivity 


3 Mg 坊 ProjectFiles | 4 图 二 | 次 I 网 activity quizxml x  @ QuizActivityjava x 入 
日 * 己 app 1 package com.bignerdranch.android, geoquiz; v9 
> Dmanifests 2 & 
网 java 3 import ... 
、 5 

人 © com.bignerdranch.android.geoquiz 6 加 pubtic class QuizActivity extends AppCompatActivity { 
上 @ = QuizActivity 
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图 1-8 新 的 项 目 窗口 


左边 是 项 目 工具 窗口 (projecttool window ), 通过 它 可 以 查看 和 管理 所 有 与 项 目 相关 的 文件 。 

主 视图 是 代码 编辑 区 ( editor )。 为 便于 开发 ,Android Studio 已 在 代码 编辑 区 打开 了 QuizActivity. 
java 文 件 。 

点 击 工作 区 窗口 左边 、 右 边 以 及 底部 标 有 各 种 名 称 的 工具 按钮 区 域 , 可 显示 或 隐藏 各 类 工具 
和 窗口。 当然 , 也 可 以 直接 使 用 它们 对 应 的 快捷 键 。 假如 看 不 到 某 个 工具 按钮 的 话 ， 可 以 点 击 左下 
角 的 灰色 方形 区 域 或 单 击 View 一 Tool Buttons 荣 单项 找到 它 。 


1.4 用 户 界 面 设计 


首先 打开 appmes/layoutactivity_quiz.xml 文 件 。 如 果 看 到 的 是 布局 预览 界面 ， 请 点 击 底部 的 
Text 页 切换 显示 XML 代码 。 






























































1.4 用 户 界面 设计 7 





当前 ，activity quiz.xml 文 件 定 义 了 默认 的 activity 布 局 。 默 认 的 XML 布局 文件 内 容 经 常 有 变 ， 
但 相 比 代码 清单 1-1， 一 般 不 会 有 很 大 出 入 。 


代码 清单 1-1 默认 的 activity 布 局 (activity_ quiz.xml ) 


<Relativelayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 


android: 


android 


android 


id="@+id/activity quiz" 


:layout width="match parent" 
android: 
:paddingBottom="16dp" 
android: 
android: 
android: 


layout _ height="match parent" 


paddingleft="16dp" 
paddingRight="16dp" 
paddingTop="16dp" 


tools:context="com.bignerdranch.android.geoquiz.QuizActivity"> 


<TextView 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:text="Hello World!"/> 
</Relativelayout> 


应 用 activity 的 默认 布局 定义 了 两 个 组 件 (widget ): RelativeLayout 和 TextView。 
组 件 是 用 户 界面 的 构造 模块 。 组 件 可 以 显示 文字 或 图 像 ， 与 用户 交互 , 甚至 布置 屏幕 上 的 其 









































他 组 件 。 按 钮 、 文 本 输入 控件 和 选择 框 等 都 是 组 件 。 
Android SDK 内 置 了 多 种 组 件 ， 通 过 配置 各 种 组 件 可 获得 所 需 的 用 户 界面 及 行为 。 每 一 个 组 


件 都 是 View 类 或 其 子 类 ( 如 TextView 或 Button ) 的 一 个 具体 实例 。 
































图 1-9 展 示 了 代码 清单 1-1 中 定义 的 RelativeLayout 和 TextView 是 如 何在 屏幕 上 显示 的 。 








TextView 


RelativeLayout 








图 1-9 显示 在 屏幕 上 的 默认 组 件 
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不 过 , 图 1-9 所 示 的 默认 组 件 并 不 是 我 们 需要 的 , QuizActivity 的 用 户 界面 需要 下 列 组 件 : 
口 一 个 垂直 LinearLayout 组 件 ; 

口 一 个 TextView 组 件 ; 
口 一 个 水 平 LinearLayout 组 件 ; 

口 两 个 Button 组 件 。 

图 1-10 展 示 了 以 上 组 件 是 如 何 构 成 QuizActivity 用 户 界面 的 。 


A700 
GeoQuiz 
LinearLayout 


| (垂直 ) 


























四 
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图 1-10 布置 并 显示 在 屏幕 上 的 组 件 


下 面 我 们 在 activity_quiz.xml 文 件 中 定义 这 些 组 件 。 

在 项 目 工具 窗口 中 找到 app/res/layout 目 录 ， 打开 activity_quiz.xml 文 件 。 对照 代 码 清单 1-2, 修 
改 文件 内 容 。 注 意 ， 需 删除 的 XML 已 打上 删除 线 ， 需 添加 的 XML 以 粗 体 显示 。 本 书 统一 使 用 这 
样 的 代码 增删 处 理 模式 。 


代码 清单 1-2 ”在 XML 文件 (activity_ quiz.xml ) 中 定义 组 件 
































1.4 用 户 界面 设计 9 




















<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match_parent" 
android:layout height="match_ parent" 
android:gravity="center" 
android:orientation="vertical" > 


<TextView 


android:layout width="wrap_content" 
android:layout_height="wrap_content" 
android:padding="24dp" 
android:text="@string/question _ text" /> 


<LinearLayout 


android:layout width="wrap_content" 
android:layout _ height="wrap_content" 
android:orientation="horizontal" > 


<Button 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:text="@string/true_ button" /> 

<Button 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:text="@string/false button" /> 

</LinearLayout> 
</LinearLayout> 


人 19 曾 时 个 更 昼 这 开罗 也 没 因 系 ，， 全 会 寿司 起 学 习 中 逐渐 弄 明 白 的 。 
意 ， 开 发 工具 无 法 校 验 布局 XML 内 容 ， 拼 写 错 误 早 晚会 出 问题 ， 应 尽量 避免 。 
可 以 看 到 ， 有 三 行 以 android:text 开 头 的 代码 出 现 了 错误 信息 。 和 暂时 忽略 它们 ， 稍 后 会 








处 理 。 




















对 照 图 1-10 所 示 的 用 户 界 面 查看 XML 文 件 ， 可 以 看 出 组 件 与 XML 元 素 一 一 对 应 。 元 素 的 名 


称 就 是 组 件 的 类 型 。 





各 元 素 均 有 一 组 XML 属性 。 属 性 可 以 看 作 如 何 配置 组 件 的 指令 。 


为 方便 理解 元 素 与 








属性 的 工作 原理 ， 接 下 来 我 们 将 以 层级 视角 来 研究 布局 。 
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1.4.1 视图 层级 结构 


组 件 包含 在 视图 ( View ) 对 象 的 层级 结构 中 , 这 种 结构 又 称 作 视图 层级 结构 (view hierarchy )。 
图 1-11 展 示 了 代码 清单 1-2 所 示 的 XML 布 局 对 应 的 视图 层级 结构 。 











LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:gravity="center" 
android:orientation="vertical" 


TextVi 
extView LinearLayout 


android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:orientation="horizontal" 


android:layout_width="wrap_content" 


android:layout_height="wrap_content" 
android:padding="24dp" 
android:text="@string/question_text" 


Button Button 
android:layout_width="wrap_content" android:layout_width="wrap_content" 
android:layout_height="wrap_content" android:layout_height="wrap_content" 
android:text="@string /true_button" android:text="@string /false_button" 








图 1-11 布局 组 件 的 层级 结构 


从 布局 的 视图 层级 结构 可 以 看 到 ， 其 根 元 素 是 一 个 LinearLayout 组 件 。 作 为 根 元 素 ， 
LinearLayout 组 件 必须 指定 Android XML 资 源 文件 的 命名 空间 属性 ， 这 里 是 http://schemas. 
android.com/apk/res/android。 

LinearLayout 组 件 继承 自 ViewGroup 组 件 (也 是 个 View 子 类 )。ViewGroup 组 件 是 包含 并 配 
置 其 他 组 件 的 特殊 组 件 。 想 要 以 一 列 或 一 排 的 样式 布置 组 件 ， 就 可 以 使 用 LinearLayout 组 件 。 
其 他 ViewGroup 子 类 还 有 FrameLayout 、TableLayout 和 RelativeLayout。 

若 某 个 组 件 包 含 在 一 个 ViewGroup 中 ， 该 组 件 与 ViewGroup 即 构成 父子 关系 。 根 Linear- 
Layout 有 两 个 子 组 件 : TextView 和 另 一 个 LinearLayout。 作 为 子 组 件 的 LinearLayout 自 己 还 
有 两 个 Button 子 组 件 。 









































1.4.2 组件 属 性 


下 面 来 看 看 配置 组 件 时 常用 的 一 些 属性 。 
1. android:Layout width 和 android:Layout_height 属 性 
几乎 每 类 组 件 都 需要 android:layout width 和 android:layout height 属 性 。 以 下 是 它 
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们 的 两 个 常见 属性 值 (二 选 一 )。 
口 match_parent: 视图 与 其 父 视图 大 小 相同 。 
口 wrap_content: 视图 将 根据 其 显示 内 容 自 动 调整 大 小 。 

(以 前 还 有 个 fiLL_parent 属 性 值 ， 等 同 于 match_parent ， 现 已 废弃 不 用 。) 

根 LinearLayout 组 件 的 高 度 与 宽度 属性 值 均 为 match_parent。LinearLayout 昌 然 是 根 元 
素 , 但 它 也 有 父 视图 一 一 Android 提 供 该 父 视图 来 容纳 应 用 的 整个 视图 层级 结构 。 

其 他 包含 在 界面 布局 中 的 组 件 ， 其 高 度 与 宽度 属性 值 均 被 设置 为 wrap_content。 请 参照 图 
1-10 理 解 该 属性 值 定义 尺寸 大 小 的 作用 。 

TextView 组 件 比 其 包含 的 文字 内 容 区 域 稍 大 一 些 , 这 主要 是 android:padding="24dp" 属 性 
的 作用 。 该 属性 告诉 组 件 在 决定 大 小 时 , 除 内 容 本 身 外 ,还 需 增 加 额外 指定 量 的 空间 。 这 样 屏幕 
上 显示 的 问题 与 按钮 之 间 便 会 留 有 一 定 的 空间 ， 使 整体 显得 更 为 美观 。( 不 理解 dp 的 意思 ? dp 即 
density-independent pixel， 指 与 密度 无 关 的 像素 ， 详 见 第 9 章 。) 

2. android:orientation 属 性 

android:orientation 属 性 是 两 个 LinearLayout 组 件 都 具有 的 属性 ， 它 决定 两 者 的 子 组 件 
是 水 平 放置 还 是 垂直 放置 。 根 LinearLayout 是 垂直 的 ， 子 LinearLayout 是 水 平 的 。 

子 组 件 的 定义 顺序 决定 其 在 屏幕 上 显示 的 顺序 。 在 垂直 的 LinearLayout 中 ， 第 一 个 定义 的 
子 组 件 出 现在 屏幕 的 最 上 端 ; 而 在 水 平 的 LinearLayout 中 ， 第 一 个 定义 的 子 组 件 出 现在 屏幕 的 
最 左 端 。( 如 果 设 备 文字 从 右 至 左 显 示 ， 如 阿拉 伯 语 或 者 希 伯 来 语 ， 第 一 个 定义 的 子 组 件 则 出 现 
在 屏幕 的 最 右 端 。) 

3. android :text 属 性 

TextView 与 Button 组 件 具 有 android:text 属 性 。 该 属性 指定 组 件 要 显示 的 文字 内 容 。 

请 注意 ，android:text 属 性 值 不 是 字符 串 值 ， 而 是 对 字符 串 资源 (string resource ) 的 引用 。 

字符 串 资源 包含 在 一 个 独立 的 名 叫 strings 的 XML 文件 中 (strings.xzml )， 虽 然 可 以 便 编码 设置 
组 件 的 文本 属性 值 ， 如 android:text="True", 但 这 通常 不 是 个 好 主意 。 比 较 好 的 做 法 是 : 将 文 
字 内 容 放 置 在 独立 的 字符 串 资 源 XML 文 件 中 ， 然 后 引用 它们 。 这 样 会 方便 应 用 的 本 地 化 ( 支持 
多 国语 言 )。 

需要 在 activity_quiz.xml 文 件 中 引用 的 字符 串 资源 还 没 添加 。 现 在 就 来 处 理 。 
















































































































































































































































































1.4.3 ”创建 字符 串 资源 

每 个 项 目 都 包含 一 个 默认 字符 串 资源 文件 strings.xml。 

在 项 目 工具 窗口 中 ， 找 到 appmes/values 目 录 ， 展 开 目 录 ， 打 开 strings.xml 文 件 。 

可 以 看 到 ， 项 目 模 板 已 经 添加 了 一 些 字符 串 资 源 。 如 代码 清单 1-3 所 示 ， 添 加 应 用 布局 需要 
的 三 个 新 的 字符 串 。 
代码 清单 1-3 ”添加 字符 串 资 源 ( strings.xml ) 


<Pesources”> 
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<string name="app_name">GeoQuiz</string> 
<string name="question_text'">Canberra is the capital of Australia.</string> 
<string name="true_button">True</string> 
<string name="false_button">False</string> 
</resources> 


( 某 些 版 本 的 Android Studio 的 strings.xml 默 认 带 有 其 他 字符 串 , 请 勿 删除 它们 , 否则 会 引发 与 
其 他 文件 的 联动 错误 。 ) 

现在 ， 在 GeoQuiz 项 目的 任何 XML 文 件 中 ， 只 要 引用 到 @string/false_button， 应 用 运行 
时 ， 就 会 得 到 文本 “False”。 

保存 strings.xml 文 件 。 这 时 ，activity_quiz.xml 布 局 缺少 字符 串 资源 的 提示 信息 应 该 就 消失 了 。 
(如 仍 有 错误 提示 ， 请 检查 一 下 这 两 个 文件 ， 确 认 没有 拼写 错误 。) 
默认 的 字符 串 文 件 虽 然 已 命名 为 strings.xml， 你 仍 可 以 按 个 人 喜好 重 命名 。 一 个 项 目 也 可 以 
有 多 个 字符 串 文 件 。 只 要 这 些 文件 都 放 在 res/values/ 目 录 下 , 含有 一 个 resources 根 元 素 , 以 及 多 
个 string 子 元 素 ， 应 用 就 能 找到 并 正确 使 用 它们 。 

















1.4.4 ”预览 布局 


至 此 ,应 用 的 界面 布局 已 经 完成 ， 可 以 使 用 图 形 布局 工具 实时 预览 了 。 首先, 确认 保存 了 所 
有 相关 文件 并 且 无 错误 发 生 ， 然 后 回 到 activity quiz.xml 文 件 ， 点 击 代 码 编 辑 区 右边 的 Preview 打 
开 预 览 工具 窗口 (如 果 还 没 打 开 的 话 )， 如 图 1-12 所 示 。 


国 BS- : DNexus 4- 六 24- (AppTheme 团 Language- :0O- 
因 ; 转 日 7% 外 回 当 : 回 
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Canberra is the capital of Australia. 
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7 
局 工具 中 预览 布局 (activity_quiz.xml ) 














图 1-12 ”在 图 


NSN 
起 
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1.5 “从 布局 XML 到 视图 对 象 | 到 


知道 activity_quiz.xml 中 的 XML 元 素 是 如 何 转换 为 视图 对 象 的 吗 ? 答案 就 在 于 QuizActivity 
类 
入 o 

在 创建 GeoQuiz 项 目的 同时 ， 向 导 也 创建 了 一 个 名 叫 QuizActivity 的 Activity 子 类 。 
QuizActivity 类 文件 存放 在 项 目的 app/java 目 录 下 。java 目 录 是 项 目 全 部 Java 源 代码 的 存放 处 。 

在 项 目 工具 窗口 中 ， 依 次 展开 app/java 目 录 与 com.bignerdranch.android.geoquiz 包 。 找 到 并 打 


开 QuizActivityjava 文 件 ， 查 看 其 中 的 代码 ， 如 代码 清单 1-4 所 示 。 
代码 清单 1-4 默认 QuizActivity 类 文件 ( QuizActivityjava ) 


package com.bignerdranch.android.geoquiz; 











import android.support.v7.app.AppCompatActivity 
import android.os.Bundle; 


public class QuizActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity quiz); 

上 


(是 不 是 不 明白 AppCompatActivity 的 作用 ? 它 实际 就 是 一 个 Activity 子 类 ， 能 为 Android 
旧版 本 系统 提供 兼容 支持 。 第 13 章 会 详细 介绍 AppCompatActivity。) 
如 果 无 法 看 到 全 部 类 包 导 入 语句 ， 请 单 击 第 一 行 导入 语句 左边 的 @ 符 号 来 显示 它们 。 

该 Java 类 文件 有 一 个 Activity 方 法 : onCreate (Bundle)。 

(如 果 你 的 文件 还 包含 onCreate0ptionsMenu(Menu) 和 on0ptionsItemSeLected(MenuItem) 
方法 ， 暂 时 不 用 理会 。 第 13 章 会 详细 介绍 它们 。) 

activity 子 类 的 实例 创建 后 ，onCreate (Bundle) 方 法 会 被 调用 。activity 创 建 后 ， 它 需要 获取 
并 管理 用 户 界 面 。 要 获取 activity 的 用 户 界 面 ， 可 调用 以 下 Activity 方 法 : 

public void setContentView(int layoutResID) 

根据 传人 的 布局 资源 ID 参数 , 该 方法 生成 指定 布局 的 视图 并 将 其 放置 在 屏幕 上 。 布局 视图 生 
成 后 ， 布 局 文件 包含 的 组 件 也 随 之 以 各 自 的 属性 定义 完成 实例 化 。 


资源 与 资源 ID 
布局 是 一 种 资源 。 资 源 是 应 用 非 代 码 形式 的 内 容 ， 如 图 像 文件 、 音 频 文件 以 及 XML 文件 等 。 
项 目的 所 有 资源 文件 都 存放 在 目录 appmres 的 子 目 录 下 。 在 项 目 工具 窗口 中 可 以 看 到 ， 
activity quiz.xml 布 局 资源 文件 存放 在 reylayout 目录 下 。strings.xml 字 符 串 资源 文件 存放 在 
res/values/ 目 录 下 。 
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可 以 使 用 资源 了 D 在 代码 中 获取 相应 的 资源 。activity_quiz.xml 布 局 的 资源 略为 R.layout. 
activity quiz。 

查看 GeoQuiz 应 用 的 资源 ID 需要 切换 项 目 视图 。Android Studio 默 认 使 用 Android 项 目 视图 ， 
如 图 1-13 所 示 。 为 让 开发 者 专注 于 最 常用 的 文件 和 目录 , 默认 视图 隐藏 了 Android 项 目的 真实 文件 
目录 结构 。 








D3 GeoQuiz 
EE 
2 Bapp Packages 
到 户 manij Scratches 
两 * Djava V Android 

p Cares Project Files 

‘DGradles Problems 

Production 


Tests 
Tests 
Android Instrumentation Tests 


图 1-13 ”切换 项 目 视 图 


eq 7: Structure 








在 项 目 工具 窗口 的 最 上 部 找到 下 拉 菜 单 , 从 Android 项 目 视 图 切换 至 Project 视 图 。Project 视 图 
会 显示 出 当前 项 目的 所 有 文件 和 目录 。 

展开 目录 app/build/generated/source/r/debug， 找 到 项 目 包 名 称 并 打开 其 中 的 R.java 文 件 ， 即 可 
看 到 GeoQuiz 应 用 当前 所 有 的 资源 。R.java 文 件 在 Android 项 目 编译 过 程 中 自动 生成 ， 如 该 文件 头 
部 的 警示 所 述 ， 请 不 要 修改 该 文件 的 内 容 。 

修改 布局 或 字符 串 等 资源 后 ，R.java 文 件 不 会 实时 刷新 。Android Studio 另 外 还 存 有 一 份 代码 
编译 用 的 Rjava 隐 藏 文件 。 当 前 代码 编辑 区 打开 的 R.java 文 件 仅 在 应 用 安装 至 设备 或 模拟 器 前 产 
生 ， 因 此 只 有 在 Android Studio 中 点 击 运行 应 用 时 ， 它 才 会 得 到 更 新 。 

R.java 文 件 通常 比较 大 ， 代 码 清单 1-5 仅 展示 了 部 分 内 容 。 


代码 清单 1-5 GeoQuiz 应 用 当前 的 资源 ID ( R.java) 
/* AUTO-GENERATED FILE. DO NOT MODIFY . 
* 












































* This class was automatically generated by the 
* aapt tool from the resource data it found. It 
* should not be modified by hand. 

*/ 


package com.bignerdranch.android.geoquiz; 


public final class R { 
public static final class anim { 


} 


public static final class id { 
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} 


public static final class layout { 


public static final int activity quiz=0x7f030017; 


public static final class mipmap { 
public static final int ic_Launcher=0x7f030000 ; 


} 


public static final class string { 


public static final int app_name=0x7f0a0010; 
public static final int false button=0x7f0a0012; 
public static final int question text=0x7f0a0014; 
public static final int true_button=0x7f0a0015 ; 


. 


可 以 看 到 R.layout.activity_quiz 即 来 自 该 
整 型 常量 
了 E Le 























文件 。activity_quiz 是 R 的 内 部 类 Layout 里 的 一 个 


GeoQnuiz 应 用 需要 的 字符 串 同样 具有 资源 ID。 目 前 为 止 ， 我 们 还 未 在 代码 中 引用 过 字符 串 ， 





如 果 需 要 ， 可 以 使 用 以 下 方法 : 


setTitle(R.string.app_name); 


Android 为 整个 布局 文件 以 及 各 个 字符 中 























生成 资源 ID ， 但 activity_quiz.xml 布 局 文件 中 的 组 件 








除外 ,因为 不 是 所 有 组 件 都 需要 资源 ID。 在 本 章 中 , 我 们 要 在 代码 里 与 两 个 按钮 交互 ， 因 此 只 需 


为 它们 生成 资源 了 p 即 可 。 
本 书 主要 使 用 Android 项 目 视 图 ,生成 资 
视图 ， 也 没 啥 问题 。 





源 ID 之 前 , 记得 切 回 。 当 然 , 如 果 你 就 喜欢 使 用 Project 


要 为 组 件 生成 资源 ID ， 请 在 定义 组 件 时 为 其 添加 android':id 属 性 。 在 activity_quiz.xml 文 件 
中 ， 分 别 为 两 个 按钮 添加 上 android:id 属 性 ， 如 代码 清单 1-6 所 示 。 


代码 清单 1-6 ”为 按钮 添加 资源 ID (activity_quiz.xml ) 








<LinearLayout ... > 


<TextView 


android:layout width="wrap_content" 
android:layout height="wrap_ content" 


android:padding="24dp" 


android:text="@string/question text" /> 


<LinearLayout 


android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:orientation="horizontal"> 


<Button 


android:id="@+id/true_button" 
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android:layout width="wrap_content " 

android:layout height="wrap content" 
android:text="@string/true button" /> 
<Button 





android:id="@+id/false_button" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:text="@string/false button" /> 
</LinearLayout> 
</LinearLayout> 
注意 ，android:id 属 性 


们 在 创建 资源 ID ， 而 对 字符 串 资源 只 是 做 引用 。 


E 值 前 面 有 一 个 + 标志 ， 而 android:text 属 性 值 则 没有 。 这 是 因为 我 
1.6 ”组件 的 实际 应 用 























中 增加 两 个 成 员 变 量 。 


按钮 有 了 资源 ID ， 就 可 以 在 QuizActivity 中 直接 获取 它们 。 首 先 ， 在 QuizActivityjava 文 件 





在 QuizActivityjava 文 件 中 输入 代码 清 年 
代码 清单 1-7 





添加 成 员 变 量 ( QuizActivity.java ) 





1-7 所 示 代 码 。( 请 勿 使 用 代码 自动 补 全 功能 。) 
public class QuizActivity extends AppCompatActivity { 
private Button mTrueButton; 

private Button mFalseButton; 
@Override 


} 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
} 


setContentView(R.layout.activity quiz); 


又 
级 。 


变量 名 称 的 m 前 








该 前 级 是 


文件 保存 后 ,会 看 到 两 个 错误 提示 。 没 关系 ， 稍 后 会 处 理 。 请 注意 新 增 的 两 个 成 员 ( 实例 ) 
symbol 'Button'。 




















头 部 手动 输入 以 下 代码 : 





Android 编 程 应 遵循 的 命名 约定 ， 本 书 将 始终 遵循 该 约定 。 
现在 ， 将 鼠标 移 至 代码 左边 的 错误 提示 处 时 ， 会 看 到 两 条 同样 的 错误 信息 


Cannot resolve 


也 可 以 使 用 该 组 合 键 来 修正 。 





这 告诉 我 们 ， 需 要 在 QuizActivityjava 文 件 中 导入 android.widget .Button 类 包 。 可 在 文件 
import android.widget.Button; 


或 者 使 用 Option+Return ( Alt+Enter ) 组 合 键 ， 让 Android Studio 自 动 为 你 导入 。 代 码 有 误 时 ， 
记得 要 常用 。 
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类 包 导 和 后， 刚才 的 错误 提示 应 该 就 消失 了 。( 如 果 仍 然 存在 ， 请 检查 Java 代 码 以 及 XML 文 Pa 
件 ， 确 认 是 否 存在 输入 或 拼写 错误 , ) 
接 下 来 ,我 们 来 编码 使 用 按钮 组 件 ， 这 需要 以 下 两 个 步 又: 
口 引用 生成 的 视图 对 象 ; 
口 为 对 象 设置 监听 器 ， 以 响应 用 户 操作 。 


1.6.1 引用 组 件 
在 activity 中 ， 可 调用 以 下 Activity 方 法 引用 已 生成 的 组 件 : 
public View findViewById(int id) 
该 方法 以 组 件 的 资源 ID 作为 参数 ， 返 回 一 个 视图 对 象 。 
在 QuizActivityjava 文 件 中 , 使 用 按钮 的 资源 ID 获 取 视 图 对 象 , 赋值 给 对 应 的 成 员 变量 ,如 代 
码 清单 1-8 所 示 。 注 意 ， 赋 值 前 ， 必 须 先 将 返回 的 View 类 型 转换 为 Button。 


代码 清单 1-8 引用 组 件 ( QuizActivity.java ) 


public class QuizActivity extends AppCompatActivity { 
































T 





private Button mTrueButton; 
private Button mFalseButton; 


@Override 

protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity quiz); 


mTrueButton = (Button) findViewById(R.id.true button); 
mFalseButton = (Button) findViewById(R.id.false_ button); 


1.6.2 设置 监听 器 


Android 应 用 属于 典型 的 事件 驱动 类 型 。 不 像 命令 行 或 脚本 程序 ， 事件 驱动 型 应 用 启动 后 ， 
即 开始 等 待 行为 事件 的 发 生 ， 如 用 户 点 击 某 个 按钮 。( 事件 也 可 以 由 操作 系统 或 其 他 应 用 触发 ， 
但 用 户 触发 的 事件 更 直观 ， 如 点 击 按钮 。) 

应 用 等 待 某 个 特定 事件 的 发 生 ， 也 可 以 说 应 用 正在 “监听 ”特定 事件 。 为 响应 某 个 事件 而 创 
建 的 对 象 叫 作 监 听 器 (listener )。 监 听 器 会 实现 特定 事件 的 监听 器 接口 ( listener interface )。 
无 需 自 己 动手 ，Android SDK 已 经 为 各 种 事件 内 置 了 很 多 监听 器 接口 。 当 前 应 用 需要 监听 用 
户 的 按钮 “点 击 ” 事 件 ， 因 此 监听 器 需 实现 View.0nClickListener 接 口 。 
首先 处 理 TRUE 按 钮 。 在 QuizActivity.java 文 件 中 ， 在 onCreate (Bundle) 方 法 的 变量 赋值 语 
句 后 输入 下 列 代码 ， 如 代码 清单 1-9 所 示 。 











由 
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代码 清单 1-9 为 TRUE 按钮 设置 监听 器 〈QuizActivityjava ) 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity quiz); 


mTrueButton = (Button) findViewById(R.id.true button); 
mTrueButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// Does nothing yet, but soon! 








} 
}); 
mFalseButton = (Button) findViewById(R.id.false button); 
} 
} 
(如 果 遇 到 View cannot be resolved to atype 的 错误 提示 ， 请 使 用 Option+Return ( AlttEnter ) 快 
捷 键 导入 View 类 。 ) 





在 代码 清单 1-9 中 ， 我 们 设置 了 一 个 监听 器 。 按 钮 nTrueButton 被 点 击 后 ， 监 听 器 会 立即 通 
知 我 们 。 传 人 set0nCLickListener(OnCLickListener) 方 法 的 参数 是 一 个 监听 器 。 它 是 一 个 实 
现 了 0nClickListener 接 口 的 对 象 。 

使 用 匿名 内 部 类 

这 里 , 一 个 匿名 内 部 类 ( anonymous inner class ) 实现 了 0nClickListener 接 口 。 语 法 看 上 去 
稍 显 复杂 ， 不 过 有 个 助 记 小 技巧 : 最 外 层 一 对 括号 内 的 全 部 代码 就 是 传人 set0nCLickListener 
(OnCLickListener) 方 法 的 参数 。 


mTrueButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// Does nothing yet, but soon! 



































} 
}); 


本 书 所 有 的 监听 器 都 以 匿名 内 部 类 来 实现 。 这 样 做 有 两 大 好 人 处。 第 一 , 使 用 匿名 内 部 类 ， 可 
以 相对 集中 地 实现 监听 器 方法 , 一 眼 可 见 ; 第 二 , 事件 监听 器 一 般 只 在 一 个 地 方 使 用 , 使 用 匿名 
内 部 类 ， 就 不 用 去 创建 繁琐 的 命名 类 了 。 

匿名 内 部 类 实现 了 0nClickListener 接 口 ， 因 此 它 也 必须 实现 该 接口 唯一 的 onClick(View) 
方法 。onClick(View) 现 在 是 个 空 方法 。 虽然 必须 实现 onClick(View) 方 法 , 但 具体 如 何 实现 取 
决 于 使 用 者 ， 因 此 即使 是 个 空 方法 ,编译 器 也 可 以 编译 通过 。 

(如 果 匿 名 内 部 类 、 监 听 器 、 接 口 等 概念 已 忘 得 差不多 了 ， 现 在 就 该 去 复习 一 下 ， 或 找 本 参 
考 手 册 备 查 。) 

参照 代码 清单 1-10 为 FALSE 按 钮 设置 类 似 的 事件 监听 器 。 
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代码 清单 1-10 ”为 FALSE 按 钮 设置 监听 器 《QuizActivityjava ) 


mTrueButton.setOnClickListener(new View.0nCLickListener() { 
GOverride 
public void onClick(View v) { 
// Does nothing yet, but soon! 





} 
}); 


mFalseButton = (Button) findViewById(R.id.false button); 
mFalseButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// Does nothing yet, but soon! 


}); 


1.7 创建 提示 消息 


接 下 来 要 实现 的 是 ， 分 别 点 击 两 个 按钮 ， 弹 出 我 们 称 之 为 toast 的 提示 消息 。Android 的 toast 
是 用 来 通知 用 户 的 简短 弹出 消息 ， 用 户 无 需 输 入 什么 ,也 不 用 做 任何 干预 操作 。 这 里 ,我 们 要 用 
toast 来 反馈 答案 ， 如 图 1-14 所 示 。 


BA RA 
GeoQuiz 



































Canberra is the capital of Australia 


TRUE FALSE 


图 1-14 toast 消 息 反馈 


首先 回 到 strings.xml 文 件 ， 如 代码 清单 1-11 所 示 ， 为 toast 添 加 消息 显示 用 的 字符 串 资源 。 
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代码 清单 1-11 增加 toast 字 符 串 〈strings.xml ) 


<resources> 
<string name="app_ name">GeoQuiz</string> 
<string name="question text">Canberra is the capital of Australia.</string> 
<string name="true button">True</string> 
<string name="false button">False</string> 
<string name="correct toast">Correct!</string> 
<string name="incorrect toast">Incorrect!</string> 
</resources> 


调用 Toast 类 的 以 下 方法 ， 可 创建 toast: 

public static Toast makeText(Context context, int resId, int duration) 

该 方法 的 Context 参 数 通常 是 Activity 的 一 个 实例 (Activity 本 身 就 是 Context 的 子 类 )。 
第 二 个 参数 是 toast 要 显示 字符 串 消 息 的 资源 ID 。Toast 类 必须 借助 Context 才 能 找到 并 使 用 字符 
串 资源 ID。 第 三 个 参数 通常 是 两 个 Toast 常 量 中 的 一 个 ， 用 来 指定 toast 消 息 的 停留 时 间 。 

创建 toast 后 ， 可 调用 Toast ,show() 方 法 在 屏幕 上 显示 toast 消 息 。 

在 QuizActivity 代 码 里 ,分 别 调用 makeText(...) 方 法 ， 如 代码 清单 1-12 所 示 。 在 添加 
makeText(...) 时 ， 可 利用 Android Studio 的 代码 自动 补 全 功能 ， 让 代码 输入 更 轻松 。 


使 用 代码 自动 补 全 


代码 自动 补 全 功能 可 以 节约 大 量 开 发 时 间 ， 越 早 掌握 受益 越 多 。 

参照 代码 清单 1-12， 依 次 输入 代码 。 当 输入 到 Toast 类 后 的 点 号 时 ，Android Studio 会 弹出 一 
个 窗口 ， 窗 口内 显示 了 建议 使 用 的 Toast 类 的 常量 与 方法 。 

要 选择 需要 的 建议 方法 ,使 用 上 下 键 。( 如 果 不 想 使 用 代码 自动 补 全 功能 ， 请 不 要 按 Tab 键 、 
Return/Enter 键 ， 或 使 用 鼠标 点 击 弹出 窗口 ， 只 管 继续 输入 代码 直至 完成 。) 

在 建议 列表 里 ， 选 择 makeText(Context context，int resID，int duration) 方 法 ， 代 
码 自动 补 全 功能 会 自动 添加 完整 的 方法 调用 。 

完成 makeText 方 法 的 全 部 参数 设置 ， 完 成 后 的 代码 如 代码 清单 1-12 所 示 。 


代码 清单 1-12 创建 提示 消息 ( QuizActivity.java ) 


mTrueButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Toast .makeText (QuizActivity. this, 
R.string.correct toast, 
Toast .LENGTH_SHORT) .show(); 
/AH Does nothing yet, but soont! 














































































































} 
}); 
mFalseButton = (Button) find ViewById(R.id.false button); 
mFalseButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
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Toast.makeText (QuizActivity.this, 
R.string.incorrect toast, 
Toast .LENGTH_SHORT) .show() ; 
/AH Does nothing yet, but soont! 





} 
}); 


在 makeText(,..) 里 ， ei se. 注意 此 处 应 输入 的 
et this， 不 要 想当然 地 直接 输入 this。 因 为 匿名 类 的 使 用 ， 这 里 的 this 指 
的 是 监听 器 View. 

使 用 代码 自动 补 全 功能 ， 自 己 也 就 不 用 导入 Toast 类 了 了 ， 因 为 Android Studio 会 自动 导入 相 
关 类 。 

好 了 ， 现 在 可 以 运行 应 用 了 。 


1.8 使 用 模拟 器 运行 应 用 


运行 Android 应 用 需 使 用 硬件 设备 或 虚拟 设备 (virtual device )。 包 含 在 开发 工具 中 的 Android 
设备 模拟 器 可 提供 多 种 虚拟 设备 。 

要 创建 Android 虚 拟 设 备 (AVD ), 在 Android Studio 中 , 选择 Tools 一 Android 一 AVD Manager 
菜单 项 。AVD 管 理 需 窗口 弹出 时 ， 点 击 窗口 左下 角 的 +Create Virtual Device... 按 钮 。 

在 随后 弹出 的 对 话 框 中 , 可 以 看 到 有 很 多 配置 虚拟 设备 的 选项 。 对 于 首 个 虚拟 设备 ,我 们 选 
择 模拟 运行 Nexus 5X 设 备 ， 如 图 1-15 所 示 。 点 击 Next 继 续 



































Virtual Device Configuration 


Select Hardware 


4 Android Studio 


Choose a device definition 


本 





[DD Nexus 5X 
Category Name Size Resolution Density 
TV NexusS 4.0° 480x800 hdpi 
Wear Nexus One 3.7" 480x800 hdpi ea 
Size: large 
EE Nexus 6P 5.7° 1440x2560 。 560dpi at M0 

Tablet Nexus 6 1440x2560 S60dpi 

Nexus 5 1080x1920 xxhdpi 

Nexus 4 4.7° 768x1280 xhdpi 

Galaxy Nexus 4.65" 720x1280 xhdpi 

5.4" FWVCA 5.4" 480x854 mdpi 
New Hardware Profile Import Hardware Profies [2 Clone Device... 
3 Cancel | P Finis 


图 1-15 ”创建 新 的 AVD 
如 图 1-16 所 示 , 接 下 来 选择 模拟 器 的 系统 镜像 。 选 择 x86 Nougat 模 拟 需 后 点 击 Next 按 钮 继续 
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(在 点 击 Next 按 钮 之 前 ， 可 能 需要 下 载 模拟 器 组 件 。 按 照 提 示 操 作 即 可 。) 


© 80 Virtual Device Configuration 


System Image 


Wy 
/以 Android Studio 


Select a System image 


Recommended 三 汪 otherimaoes 








Nougat 
Release Name APlLevel ABl Target 
lz ee | Hin 
Nougat Download 24 x86_64 Android 7.0 24 
Marshmallow Download 23 x86_64 Android 6.0 
Androld 
Marshmallow Download 23 x86 Android 6.0 了 7.0 
1 Lp 
Lollipop Download 22 x86_64 Android 5.1 3 od YY Android Open 
Lollipop Download 22 x86 Android 5.1 Source Project 
Lollipop Download 21 x86_64 Android 5.0 (with Google AF 
System Image 
Lollipop Download 21 x86 Android 5.0 (with Google AF x86 
Lollipop Download 21 x86_64 Android 5.0 Recommendation 
Lollipop Download 21 x86 Android 5.0 Consider using a system image with Google 
Apls to enable testing with Google Play 
KitKat 19 x86 Android 4.4 (with Google AP Services. 


KitKat 19 x86 Android 4.4 


Questions on APl level? 


Ennshn_ AM nasnl Ainenibnlnn ohne 


Cancel | Provows | 有 Fin 
图 1-16 ”选择 系统 镜像 


最 后 ， 可 以 对 模拟 器 的 各 项 参数 做 最 终 修改 并 确认 ， 如 图 1-17 所 示 。 当 然 ， 如 果 有 需要 ， 也 
可 以 事后 再 编辑 修改 模拟 需 的 各 项 参数 。 现 在 ， 为 模拟 需 取 个 便于 识别 的 名 称 ， 然 后 点 击 Finish 
按钮 完成 虚拟 设备 的 创建 。 

















@ Virtual Device Configuration 





Android Virtual Device (AVD) 


J 
Android Studio 





Verify Configuration 
AVD Name | Nexus 5X AP| 24 AVD Name 
[DD Nexus 5x 5.2 1080x1920 420dpi Change... | 
The name of this AVD. 
重 Nougat Android 7.0 x86 Change... 
Startup orientation 品 
Portrait Landscape 
Recommendation 
Emulated 
te Graphics: Automatic 日 Consider using a system image with Google APls to 


enable testing with Google Play Services. 


Device Frame Enable Device Frame 


Show Advanced Settings 


3 Cancel Previous Nex 


图 1-17 模拟 器 参数 调整 
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AVD 创 建成 功 后 ， 我 们 用 它 运行 GeoQuiz 应 用 。 点 击 Android Studio 工 具 栏 上 的 Run 按 钮 ,或 
者 使 用 Control+R 快 捷 键 。Android Studio 会 自动 找到 新 建 的 虚拟 设备 ， 安 装 应 用 包 ( APK ), 然后 
启动 并 运行 应 用 。 

模拟 器 的 启动 过 程 0 请 耐心 等 待 。 等 设备 启动 完成 ,应 用 运行 后 ， 就 可 以 在 应 用 界 
面 点 击 按钮 ， 让 toast 告 诉 你 答 

假如 启动 时 或 在 点 时 Geoouiz 应 用 央 溃 ， 可 以 在 Android DDMS 工 具 窗 口 的 LogCat 
视图 中 看 到 有 用 的 诊断 信息 。( 如 果 LogCat 没 有 自动 打开 ， 可 点 击 Android Studio 窗 口 底部 的 
Android Monitor 按 钮 打开 它 。) 查看 日 志 ， 可 看 到 抢眼 的 红色 异常 信息 ， 如 图 1-18 所 示 。 





























Text 

at dalvik.system.NativeStart.main (Native Method) 

Caused by: java.lang.NullPointerException 

at com.bignerdranch.android.geoquiz.QuizActivity.onCreate (QuizActivity.java:21) 
at android.app.Activity.performCreate (Activity.java:S5008) 








at android.app.Instrumentation.callActivityOnCreate (Instrumentation.java:1079) 








图 1-18 ”第 21 行 代码 处 发 生 了 NullPointerException 异 常 


将 输入 的 代码 与 书 中 的 代码 作 一 下 比较 , 找 出 错误 并 修改 ,尝试 重新 运行 应 用 ( 接 下 来 的 两 
章 还 会 深入 介绍 LogCat 和 代码 调试 的 知识 

最 好 不 要 关 掉 模拟 器 ， 这 样 就 不 必 在 反复 运行 调试 应 应 用 时 ， 浪 费时 间 等 待 AVD 启 动 了 。 

单 击 AVD 模 拟 器 上 的 后 退 按钮 可 以 停止 应 用 。 这 个 后 退 按钮 的 形状 像 一 个 指向 左 侧 的 三 角形 
(在 较 早 版 本 的 Android 中 ， 它 像 一 个 U 型 箭头 )。 需 要 调试 变更 时 ， 再 通过 Android Studio 重 新 运 
行 应 用 。 

模拟 器 虽然 好 用 ， 但 在 实体 设备 上 测试 应 用 能 获得 更 准确 的 结果 。 在 第 2 章 中 ， 我 们 会 在 实 
体 设 备 上 运行 GeoQuiz 应 用 ， 还 会 为 GeoQuiz 应 en 

















1.9 深入 学 习 : Android 编译 过 程 


学 习 到 这 里 ,你 可 能 迫切 想 知道 Android 是 如 何 编 译 的 。 你 已 经 知道 在 项 目 文件 发 生变 化 时 ， 
Android Studio 无 需 指 示 便 会 自动 进行 编译 。 在 整个 编译 过 程 中 ，Android 开 发 工具 将 资源 文件 、 
代码 以 及 AndroidManifest.xml 文 件 (包含 应 用 的 元 数据 ) 编译 生成 .apk 文 件 。.apk 文 件 要 在 模拟 器 上 
运行 ， 还 需 以 debug key 签 名 。( 分 发 .apk 应 用 给 用 户 时 ， 应 用 必须 以 release key 签 名 。 更 多 有 关 编 译 

过 程 的 信息 ， 可 参考 Android 开 发 文档 网 页 developer.android.com/tools/publishing/preparing.html。 ) 

那么 ， 应 用 的 activity_quiz.xml 布 局 文件 的 内 容 该 如 何 转变 为 View 对 象 呢 ? 作为 编译 过 程 的 
一 部 分 ，aapt ( Android Asset Packaging Tool ) 将 布局 文件 资源 编译 压缩 紧凑 后 ， 打 包 到 .apk 文 件 
中 。 然 后， 在 QuizActivity 类 的 onCreate (Bundle) 方 法 调用 setContentView(...) 方 法 时 ， 
QuizAct ivity 使 用 LayoutInflater 类 实例 化 布局 文件 中 定义 的 每 一 个 View 对 象 ， 如 图 1-19 
所 示 。 
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setContentView(R.layout.activity_quiz) 
1 


<LinearLayout ...> PClassLoader.loadClass("LinearLayout")—> 


1 
1 
! 
<TextView .../> ——” ClassLoader.loadClass("TextView") 


<LinearLayout...> >ClassLoader.loadClass("LinearLayout") 


LinearLayout 











a TextView 


LinearLayout 





<Button .../> 一 一 ClassLoaderIoadClass("Button") 





<Button .../> 一 一 ClassLoaderloadClass("Button') 


v 








图 1-19 ”activity_quiz.xml 中 的 视图 实例 化 


(除了 在 XML 文 件 中 定义 视图 外 ， 也 可 以 在 activity 里 使 用 代码 创建 视图 类 
度 来 看 , 应 用 展现 层 与 逻辑 层 分 离 好 处 多 多 ,其 中 最 主要 的 一 点 是 可 以 利用 SDK 内 置 的 设备 配置 











改变 ， 这 一 点 将 在 第 3 章 中 详细 讲解 。) 


。 不过， 从 设计 角 














有 关 XML 不 同属 性 的 工作 原理 以 及 视图 如 何 显 示 在 屏幕 上 等 更 多 信息 ， 请 参见 第 9 章 。 


Android 编译 工具 











当前 ， 我 们 看 到 的 项 目 编译 都 是 在 Android Studio 里 执行 的 。 编 译 功能 已 整合 到 IDE 中 ， 




















负责 调用 aapt 等 Android 标 准 编译 工具 ， 但 编译 过 程 本 身 仍 由 Android Studio 管 理 。 
可 能 需要 脱离 Android Studio 编 译 代码 。 最 简单 的 方法 是 使 用 命令 行 





有 时 ， 出 于 某 种 原因 ， 
编译 工具 。 现 代 Android 编 译 系统 使 用 Gradle 编 译 工 具 。 










































































么 要 使 用 命令 行 工具 ， 不 在 本 书 的 讨论 范围 之 内 。) 
要 从 命令 行使 用 Gradle， 


$ ./gradlew tasks 
如 果 是 Windows 系 统 ， 执 行 以 下 命令 : 



































NI 











(注意 ， 能 读 懂 本 小 节 内 容 并 按 步 又 操作 是 最 好 的 。 如 果 看 不 懂 ， 甚 至 不 知道 为 什么 要 手工 
编译 代码 , 或 者 是 无 法 正确 使 用 命令 行 ， 也 不 必 大 在意 , i 


青 继续 学 习 下 一 章 内 容 。 如 何以 及 为 什 


请 切换 到 项 目 目录 并 执行 以 下 命令 
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> gradlew.bat tasks 
执行 以 上 命令 会 显示 一 系列 可 用 任务 。 你 需要 的 任务 是 installDebug, 因此 , 再 执行 以 下 命令 : 
$ ./gradlew installDebug 


如 果 是 Windows 系 统 ， 执 行 以 下 命令 : 

> gradlew.bat installDebug 

以 上 命令 将 把 应 用 安装 到 当前 连接 的 设备 上 , 但 不 会 运行 它 。 要 运行 应 用 , 需要 在 设备 上 手 
动 启动 。 


1.10 ”关于 挑战 练习 


本 书 大 部 分 章 末 都 安排 有 挑战 练习 ,需要 你 独立 完成 。 有 些 很 简单 ， 就 是 练习 所 学 知识 。 有 
些 较 难 ， 需 要 较 强 的 问题 解决 能 力 。 

希望 你 一 定 完成 这 些 练 习 。 攻 克 它 们 不 仅 可 以 巩固 所 学 知识 , 树立 信心 , 还 可 以 让 自己 从 被 
动 学 习 快速 成 长 为 自主 开发 的 Android 程 序 员 。 

尝试 完成 挑战 练习 时 ,， 若 一 时 陷入 困境 ， 可 休息 休息 ， 理 理 头 绪 ， 重 新 再 来 。 如 果 仍 然 无 法 
解决 ， 可 访问 本 书 论坛 forums.bignerdranch.com， 参 考 其 他 读者 发 布 的 解决 方案 。 当 然 你 也 可 以 
自己 发 布 问 题 和 答案 并 与 其 他 读者 一 起 交流 学 习 。 

为 避免 搞 乱 当前 项 目 ， 建 议 你 在 Android Studio 中 先 复制 当前 项 目 ， 然 后 在 复制 的 项 目 上 做 
练习 。 

在 你 的 计算 机 上 ， 通 过 文件 浏览 器 找到 项 目 文件 的 根 目 录 ， 复 制 一 份 GeoQuiz 文 件 并重 命 名 
为 GeoQuiz Challenge。 回 到 Android Studio 中 ， 选 择 File 一 Import Project…. 荣 单项 ， 通 过 导入 功能 
找到 GeoQuiz Challenge 并 导入 。 这 样 ， 复 制 项 目 就 在 新 窗口 中 打开 了 。 开 始 挑战 吧 ! 


1.11 挑战 练习 : 定制 toast 消息 


这 个 练习 需要 你 定制 toast 消 息 ， 改 在 屏幕 顶部 而 不 是 底部 显示 弹出 消息 。 这 需要 使 用 Toast 
类 的 setGravity 方 法 ， 并 使 用 Gravity.TOP 重 力 值 。 具 体 如 何 使 用 ， 请 参考 Android 开 发 者 文档 。 
该 方法 所 在 网 页 为 developer.android.com/reference/android/widget/Toast.html#setGravity(int, inb inb。 
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本 章 中 ,我 们 将 升级 GeoQuiz 应 用 ， 提 供 更 多 的 地 理 知识 测试 题目 ， 如 图 2-1 所 示 。 


BA A 
GeoQuiz 


Canberra is the capital of Australia. 


TRUE FALSE 


NEXT 》 


图 2-1 更 多 测试 题 








为 实现 目标 ， 需 要 为 GeoQuiz 项 目 新 增 一 个 Question 类 。 该 类 的 一 个 实例 代表 一 道 题目 。 
然后 再 创建 一 个 Question 数 组 对 象 交 由 QuizActivity 管 理 。 























2.1 创建 新 类 


在 项 目 工具 窗口 中 ， 右 键 单 击 com.bignerdranch.android.geoquiz 类 包 ， 选 择 New 一 > Java Class 
菜单 项 。 如 图 2-2 所 示 ， 类 名 处 填 和 人 Question ， 然 后 单 击 OK 按钮 。 

















Oe. Create New Class 

Name: Question 

Kind: S Class 阳 
Superclass: 

Interface(s): 

Package: com.bignerdranch.android.geoquiz 

Visibility: © Public Package Private 

Modifiers: ©@ None Abstract Final 


Show Select Overrides Dialog 


cr TD 





图 2-2 ”创建 Question 类 
在 Question.java 中 ， 新 增 两 个 成 员 变 量 和 一 个 构造 方法 ， 如 代码 清单 2-1 所 示 。 
代码 清单 2-1 Question 类 中 的 新 增 代码 ( Question.java ) 


public class Question { 


private int mTextResId; 
private boolean mAnswerTrue; 


public Question(int textResId, boolean answerTrue) { 
mTextResId = textResId; 
mAnswerTrue = answerTrue; 


} 

Question 类 中 封装 的 数据 有 两 部 分 : 问题 文本 和 问题 答案 true 或 false )。 

为 什么 mTextResId 是 int 类 型 ， 而 不 是 String 类 型 呢 ? 变量 mTextResId 用 来 保存 地 理 知识 
问题 字符 串 的 资源 ID。 资 源 ID 总 是 int 类 型 ， 所 以 这 里 设置 它 为 int 类 型 。 稍 后 会 处 理 需 要 用 到 
的 问题 字符 串 资 源 。 

新 增 的 两 个 变量 需要 getter 方 法 与 setter 方 法 。 为 避免 手工 输入 ， 可 设置 由 Android Studio 自 动 
生成 。 












































生成 getter 方法 与 setter 方法 


首先 ， 配 置 Android Studio 识 别 成 员 变 量 的 m 前 绥 。 
打开 Android Studio 首 选项 对 话 框 ( Mac 用 户 选 择 Android Studio 菜 单 , Windows 用 户 选 择 File 一 
Settings 菜 单 )。 依 次 展开 Editor 和 Code Style 选 项 ， 在 Java 选 项 下 选择 Code Generation 选 项 页 。 
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在 Naming 表 单 的 Field 一 行 中 ,添加 m 作 为 前 级 ， 如 图 2-3 所 示 。 然 后 添加 s 作 为 Static field 的 前 
级 。( GeoQuiz 项 目 不 会 用 到 s 前 级 ,但 之 后 的 项 目 会 用 到 。 ) 


Se@ Preferences 
Q Editor > Code Style > Java ® For current project Reset 


Appearance & Behavior Scheme: Default 目 Manage... 


Keymap Set from... 
Editor Tabs and Indents Spaces Wrapping and Braces Blank Lines JavaDoc Imports Arrangement Code Generation 
Ea Naming Order of Members 
Colors & Fonts 
ee Prefer longer names Static fields 
ode Style 如 i 
Y Name prefix: Name suffix: Instance fields 
C/C++ 2 Constructors 
Go Field: Lm Static methods 
Instance methods 
Static field: s 了 

HTML Static inner classes 

oN Local variable: 

Properties 

XML Final Modifier 

YAML Make generated local variables final 

Other File Types Make generated parameters final ek 
Inspections [ei 
File and Code Templates 局” Comment Code Default Visibility 
File Encodings [a Line comment at first column Escalate 
Live Templates Add a space at comment start Private 
File Types Block comment at first column package local 
Copyright [9 
站 Override Method Signature ee 

2 Cancel Appy BO 





图 2-3 ”设置 Java 代 码 风格 首选 项 


单 击 OK 按 钮 完成 。 

刚才 设置 的 前 级 有 何 作 用 ? 那 就 是 ， 需 要 Android Studio 为 nTextResId 生 成 获取 方法 时 ， 它 
生成 的 是 getTextResId() 而 不 是 getMTextResId(); 而 在 为 nAnswerTrue 生 成 获取 方法 时 ， 生 
成 的 是 isAnswerTrue( ) 而 不 是 isMAnswerTrue() 。 

回 到 Question.java 中 ， 右 击 构造 方法 后 方 区 域 , 选择 Generate... 一 Getter and Setter 荣 单项 。 选 
择 mTextResId 和 mAnswerTrue , 为 每 个 变量 都 生成 getter 方 法 与 setter 方 法 。 单 击 OK 按钮 , Android 
Studio 随 即 生 成 了 getter 与 setter 共 4 个 方法 的 代码 ， 如 代码 清单 2-2 所 示 。 


代码 清单 2-2 ”生成 getter 方 法 与 setter 方 法 ( Question.java ) 


public class Question { 























private int mTextResId; 
private boolean mAnswerTrue; 


public int getTextResId() { 
return mTextResId; 
} 


public void setTextResId(int textResId) { 
mTextResId = textResId; 
} 
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public boolean isAnswerTrue() { 
return mAnswerTrue,; 


} 


public void setAnswerTrue(boolean answerTrue) { 
mAnswerTrue = answerTrue; 


} 
} 
这 样 ，Question 类 就 完成 了 。 稍 后 ， 我 们 会 修改 QuizActivity 类 来 配合 Question 类 使 用 。 
现在 ， 先 整体 了 解 一 下 GeoQuiz 应 用 ， 看 看 各 个 类 是 如 何 协同 工作 的 。 
我 们 使 用 QuizActivity 创 建 Question 数 组 对 象 ， 继 而 通过 与 TextView 以 及 三 个 Button 的 
交互 ， 在 屏幕 上 显示 地 理 知识 问题 ， 并 根据 用 户 的 回答 作出 反馈 ， 如 图 2-4 所 示 。 

















模型 


Te 


mTextResld 
mAnswerTrue 





A 
控制 后 mQuestionBank 


QuizActivity 





mCurrentindex 


mQuestionTextView mNextButton 


视 图 布 局 》 mTrueButton mFalseButton 





[Texview | [Button | [Button | 
图 2-4 ”GeoQuiz 应 用 对 象 图 解 


























2.2 Android 与 MVC 设计 模式 


如 图 2-4 所 示 ， 应 用 对 象 分 为 模型 、 视 图 和 控制 器 三 类 。Android 应 用 基于 模型 -视图 -控制 需 
( Model-View-Controller，MVC ) 的 架构 模式 进行 设计 。MVC 设 计 模 式 表明 ， 应 用 的 任何 对 象 ， 
归根 结 底 都 属于 模型 对 象 、 视 图 对 象 以 及 控制 器 对 象 中 的 一 种 。 

口 模型 对 象 存储 着 应 用 的 数据 和 业务 逻辑 。 模 型 类 通常 用 来 映射 与 应 用 相关 的 一 些 事 物 ， 如 
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用 户 、 商 店 里 的 商品 、 服 务 器 上 的 图 片 或 者 一 段 电 视 节 目 ， 抑 或 GeoQuiz 应 用 里 的 地 理 知 识 
问题 。 模 型 对 象 不 关心 用 户 界面 ， 它 为 存储 和 管理 应 用 数据 而 生 。 
Android 应 用 里 , 模型 类 通常 就 是 我 们 创建 的 定制 类 。 应 用 的 全 部 模型 对 象 组 成 了 模型 层 。 
GeoQuiz 应 用 的 模型 层 由 Question 类 组 成 。 
口 视图 对 象 知道 如 何在 屏幕 上 绘制 自己 ， 以 及 如 何 响 应 用 户 的 输入 ， 如 触摸 动作 等 。 一 个 
简单 的 经 验 法 则 是 ， 凡 是 能 够 在 屏幕 上 看 见 的 对 象 ， 就 是 视图 对 象 。 
Android 自 带 很 多 可 配置 的 视图 类 。 当 然 ， 也 可 以 定制 开发 其 他 视图 类 。 应 用 的 全 部 视图 
对 象 组 成 了 视图 层 。 
GeoQuiz 应 用 的 视图 层 是 由 activity_ quiz.xml 文 件 中 定义 的 各 类 组 件 构 成 的 。 
口 控制 器 对 象 含有 应 用 的 逻辑 单元 ， 是 视图 对 象 与 模型 对 象 的 联系 纽带 。 控 制 器 对 象 响应 
视图 对 象 触发 的 各 类 事件 ， 此 外 还 管理 着 模型 对 象 与 视图 层 间 的 数据 流动 。 
在 Android 的 世界 里 ， 控 制 器 通常 是 Activity、Fragment 或 Service 的 子 类 (第 7 章 和 第 
28 章 将 分 别 介 绍 fragment 和 service 的 概念 )。 
GeoQnuiz 应 用 的 控制 器 层 目前 仅 由 QuizActivity 类 组 成 。 
图 2-$ 展 示 了 在 响应 诸如 单 击 按钮 等 用 户 事 件 时 ， 对 象 间 的 交互 控制 数据 流 。 注 意 ， 模 型 对 
象 与 视图 对 象 不 直接 交互 。 控 制 器 作为 它们 之 间 的 联系 纽带 ,接收 对 象 发 送 的 消息 ,然后 向 其 他 
对 象 发 送 操作 指令 。 






























































































































































用 户 与 视图 对 象 进行 交互 
| 视图 发 送 消 控制 器 更 新 
+ 一 息 到 控制 器 、、 _。。 模型 对 象 数据 、 
Sr a DY 
Y、、 控制 器 根据 模型 对 -六 _ 控制 器 从 它 的 视图 
” 象 的 变化 更 新 视图 二 20 措 开 半 


图 2-5 ”MVC 数据 控制 流 与 用 户 交 互 





使 用 MVC 设计 模式 的 好 处 


随 着 应 用 功能 的 持续 扩展 ， 应 用 往往 会 变 得 过 于 复杂 而 让 人 难以 理解 。 以 Java 类 组 织 代码 有 
助 于 从 整体 视角 设计 和 理解 应 用 。 这 样 ,我 们 就 可 以 按 类 而 不 是 按 变量 和 方法 思考 设计 开发 问题 。 

同样 ,把 Java 类 以 模型 层 \ 视 图 层 和 控制 絮 层 进行 分 类 组 织 , 也 有 助 于 我 们 设计 和 理解 Android 
应 用 。 这 样 ， 我们 就 可 以 按 层 而 非 一 个 个 类 来 考虑 设计 开发 了 。 

GeoQnuiz 应 用 虽 不 复杂 , 但 以 MVC 分 层 模 式 设 计 它 的 好 处 还 是 显而易见 的 。 接 下 来 ,我 们 会 
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升级 GeoQuiz 应 用 的 视图 层 ， 为 它 添加 一 个 NEXT 按 钮 。 你 会 发 现 ,添加 NEXT 按 钮 时 ， 可 以 不 用 
考虑 刚才 创建 的 Question 类 。 
MVC 设 计 模 式 还 便于 复 用 类 。 相 比 功能 多 而 全 的 类 ， 功 能 单一 的 专用 类 更 有 利于 代码 复 用 。 
举例 来 说 ， 模 型 类 Question 与 用 作 显 示 问 题 的 组 件 毫 无 代码 逻辑 关联 。 这 样 ， 就 很 容易 在 
应 用 里 按 需 使 用 Question 类 。 假 设 现在 想 显 示 包 含 所 有 地 理 知 识 问题 的 列表 ， 很 简单 ， 直 接 利 
用 Question 对 象 逐 条 显示 就 可 以 了 。 


2.3 更 新 视图 层 


了 解 了 MVC 设 计 模 式 后 ， 现 在 来 更 新 GeoQuiz 应 用 的 视图 层 ， 为 其 添加 一 个 NEXT 按 钮 。 

在 Android 的 世界 里 ， 视 图 对 象 通常 由 XML 布 局 文件 生成 。GeoQuiz 应 用 唯一 的 布局 定义 在 
activity_quiz.xml 文 件 中 。 布局 定义 文件 需要 更 新 的 地 方 如 图 2-6 所 示 。( 注意 ,为 节约 版 面 , 不 变 
的 组 件 属性 就 不 再 列 出 了 。 ) 









































LinearLayout 


TextView Button 
android:id="@+id/question_text_view" android:id="@+id/next_button" 
android:layout_width="wrap_content android:layout_width="wrap_content" 
android:layout_height="wrap_content" android:layout_height="wrap_content" 
android:padding="24dp" android:text=" @string/next_button" 








应 用 视图 层 所 需 的 改动 如 下 。 
口 删除 TextView 的 android:text 属 性 定义 。 再 也 不 用 硬 编码 地 理 知 识 问 题 了 。 

口 为 TextView 新 增 android:id 属 性 。TextView 组 件 需要 资源 ID ， 以 便 在 QuizActivity 代 码 
中 为 它 设 置 要 显示 的 文字 。 

口 以 根 LinearLayout 为 父 组 件 ， 新 增 一 个 Button 组 件 。 

回 到 activity quiz.xml 文 件 中 ， 完 成 XML 文件 的 相应 修改 ， 如 代码 清单 2-3 所 示 。 














代码 清单 2-3 ”新 增 按钮 以 及 对 文本 视图 的 调整 (activity_quiz.xml ) 


<LinearLayout... > 


<TextView 
android:id="@+id/question text view" 
android:layout width="wrap_ content" 
android:layout height="wrap_content" 
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android:padding="24dp" 
android:text="@string/question text" /> 


<LinearLayout ... > 
</LinearLayout> 


<Button 
android:id="@+id/next_button" 
android:layout width="wrap_content" 
android:layout_ height="wrap_content" 
android:text="@string/next_button" /> 


</LinearLayout> 


保存 activity_quiz.xml 文 件 。 这 时 ， 会 看 到 一 个 错误 提示 ， 提 醒 缺 少 字 符 串 资源 。 
回 到 res/values/strings.xml 文 件 。 重 命名 question text , 添加 新 按钮 所 需 的 字符 串 资源 定义 ， 
如 代码 清单 2-4 所 示 。 


代码 清单 2-4 ”更 新 字符 串 资源 定义 ( strings.xml ) 
<string name="app_name">GeoQuiz</string> 
<string name="question text"> Canberra is the capital of Australia.</string> 
<string name="question australia">Canberra is the capital of Australia.</string> 
<string name="true button">True</string> 
<string name="false button">False</string> 
<string name="next_ button">Next</string> 
<string name="correct toast">Correct!</string> 


既然 已 打开 strings.xml 文 件 ， 那 就 继续 添加 其 他 地 理 知识 问题 的 字符 串 ， 结果 如 代码 清单 2-5 
所 示 。 


代码 清单 2-5 ”新 增 问题 字符 串 ( strings.xml ) 


<string name="question australia">Canberra is the capital of Australia.</string> 
<string name="question oceans">The Pacific Ocean is larger than 
the AtLantic Ocean.</string> 
<string name="question mideast">The Suez Canal connects the Red Sea 
and the Indian Ocean.</string> 
<string name="question africa">The source of the Nile River is in Egypt.</string> 
<string name="question_ americas">The Amazon River is the Longest river 
in the Americas.</string> 
<string name="question asia">Lake Baikal is the world\'s oldest and deepest 
freshwater lake.</string> 


























注意 最 后 一 个 字符 串 定义 中 的 \'。 为 得 到 符号 '， 这 里 使 用 了 转 义 字符 。 在 字符 串 资 源 定义 
中 ， 也 可 使 用 其 他 常见 的 转 义 字符 ， 比 如 \n 是 指 新 行 符 。 
保存 修改 过 的 文件 , 然后 回 到 activity_quiz.xml 文 件 中 , 在 图 形 布局 工具 里 预览 修改 后 的 布局 
文件 。 
至 此 ，GeoQuiz 应 用 视图 层 的 更 新 就 全 部 完成 了 。 为 让 GeoQuiz 应 用 跑 起 来 ， 接 下 来 要 更 新 
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控制 层 的 QuizActivity 类 。 


2.4 更 新 控制 器 层 


在 上 一 章 ,应 用 控制 器 层 的 QuizActivity 类 的 处 理 逻 辑 很 简单 :显示 定义 在 activity_quiz.xml 
文件 中 的 布局 对 象 ， 为 两 个 按钮 设置 监听 器 ， 实 现 响应 用 户 点 击 事件 并 创建 toast 消 息 。 

既然 现在 有 更 多 的 地 理 知识 问题 可 以 检索 与 展示 ，QuizActivity 类 就 需要 更 多 的 处 理 逻 辑 
来 让 GeoQuiz 应 用 的 模型 层 与 视图 层 协作 。 

打开 QuizActivityjava 文 件 ， 添 加 TextView 和 新 Button 变 量 。 另 外 ， 再 创建 一 个 Question 
对 象 数组 以 及 一 个 该 数组 的 索引 变量 ， 如 代码 清单 2-6 所 示 。 


代码 清单 2-6 ”增加 按钮 变量 及 Question 对 象 数组 (QuizActivityjava ) 
public class QuizActivity extends AppCompatActivity { 












































private Button mTrueButton; 
private Button mFalseButton; 
private Button mNextButton; 
private TextView mQuestionTextView; 


private Question[] mQuestionBank = new Question[] { 
new Question(R.string.question australia, true), 
new Question(R.string.question_ oceans, true), 
new Question(R.string.question mideast, false), 
new Question(R.string.question africa, false), 
new Question(R.string.question americas, true), 
new Question(R.string.question asia, true) 


}; 


private int mCurrentIndex = 0; 























这 里 ， 我 们 通过 多 次 调用 Question 类 的 构造 方法 ,创建 了 Question 对 象 数 组 。 

(在 更 为 复杂 的 项 目 里 ， 这 类 数组 的 创建 和 存储 会 单独 处 理 。 在 后 续 应 用 开发 中 ， 会 介绍 更 
好 的 模型 数据 存储 管理 方式 。 现 在 ， 简 单 起 见 ， 我 们 选择 在 控制 器 层 代 码 中 创建 数组 。) 

要 在 屏幕 上 显示 一 系列 地 理 知 识 问题 , 可 以 使 用 mQuestionBank 数 组 、 mCurrentIndex 变 量 
以 及 Question 对 象 的 存 取 方 法 。 

首先 ， 引 用 TextView， 并 将 其 文本 内 容 设 置 为 当前 数组 索引 所 指向 的 地 理 知识 问题 ， 如 代 
码 清单 2-7 所 示 。 


代码 清单 2-7 使 用 TextView ( QuizActivity.java ) 
public class QuizActivity extends AppCompatActivity { 











@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


34 第 2 章 Android 与 MVC 设计 模式 





SetContentView(R.Layout .activity quiz); 


mQuestionTextView = (TextView) findViewById(R.id.question text view); 
int question = mQuestionBank[mCurrentIndex] .getTextResId() ; 
mQuestionTextView.setText (question); 


mTrueButton = (Button) findViewById(R.id.true button); 


} 
保存 所 有 文件 ， 确 保 没 有 错误 发 生 。 然 后 运行 GeoQuiz 应 用 。 可 看 到 数组 存储 的 第 一 个 问题 
显示 在 TextView 上 了 。 
现在 我 们 来 处 理 NEXT 按 钮 。 首 先 引 用 NEXT 按 钮 ， 然 后 为 其 设置 监听 器 View.0nCLick- 
Listener。 该 监听 器 的 作用 是 : 递增 数组 索引 并 相应 地 更 新 TextView 的 文本 内 容 ， 如 代码 清单 
2-8 所 示 。 


代码 清单 2-8 使 用 新 增 的 按钮 (QuizActivityjava ) 


public class QuizActivity extends AppCompatActivity { 




















@Override 
protected void onCreate(Bundle savedInstanceState) { 


mFalseButton.setOnClickListener(new View.0nCLickListener() { 


} 
}); 


mNextButton = (Button) findViewById(R.id.next button); 
mNextButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
mCurrentIndex = (mCurrentIndex + 1) % mQuestionBank.Length ; 
int question = mQuestionBank[mCurrentIndex] .getTextResId(); 
mQuestionTextView. setText (question); 


}); 





可 以 看 到 ， 更 新 mQuestionTextView 变 量 的 相同 代码 分 布 在 两 个 不 同 的 地 方 。 参 照 代码 清 
单 2-9 , 花 点 时 间 把 公共 代码 放 在 单独 的 私有 方法 里 ,然后 在 mNextButton 监 听 器 里 以 及 onCreate 
(Bundle) 方 法 的 末尾 分 别 调用 它 ， 以 初步 设置 activity 视 图 中 的 文本 。 
代码 清单 2-9 使 用 updateQuestion() 封 装 公共 代码 ( QuizActivity.java ) 


public class QuizActivity extends AppCompatActivity { 

















@Override 
protected void onCreate(Bundle savedInstanceState) { 
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mQuestionTextView = (TextView) findViewById(R.id.question text view); 
oh = ih0 ionBank [mC Index] TextResId(); 
| A 


mNextButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
mCurrentIndex = (mCurrentIndex + 1) % mQuestionBank.Length ; 
: 本 ， 
ee GO 


updateQuestion(); 





} 
}); 


updateQuestion(); 


} 


private void updateQuestion() { 
int question = mQuestionBank[mCurrentIndex] .getTextResId(); 
mQuestionTextView.setText(question) ; 


} 

运行 GeoQuiz 应 用 ， 验 证 新 增 的 NEXT 按 钮 。 

一 切 正常 的 话 ， 问 题 应 该 已 经 完美 显示 出 来 了 。 当 前 ，GeoQuiz 应 用 认为 所 有 问题 的 答案 都 
是 tue， 下 面 着 手 修正 这 个 逻辑 错误 。 同 样 ， 为 避免 代码 重复 ， 我 们 将 解决 方案 封装 在 一 个 私有 
方法 里 。 

要 添加 到 QuizActivity 类 的 方法 如 下 : 

private void checkAnswer(boolean userPressedTrue) 

该 方法 接受 布尔 类 型 的 变量 参数 ， 判 别 用 户 单 击 了 TRUE 还 是 FALSE 按 钮 。 然 后 ， 将 用 户 的 
答案 同 当前 Question 对 象 中 的 答案 作 比 较 。 最 后 ， 判 断 答案 正确 与 否 ， 生 成 一 个 toast 消 息 反馈 
给 用 户 。 

在 QuizActivityjava 文 件 中 ， 添 加 checkAnswer(bootean) 方 法 的 实现 代码 ， 如 代码 清单 2-10 
所 示 。 


代码 清单 2-10 ”增加 checkAnswer(boolean) 方 法 ( QuizActivity.java ) 
public class QuizActivity extends AppCompatActivity { 




















@Override 

protected void onCreate(Bundle savedIinstanceState) { 
} 

private void updateQuestion() { 


int question = mQuestionBank[mCurrentIndex] .getTextResId() ， 
mQuestionTextView.setText (question); 
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private void checkAnswer(boolean userPressedTrue) { 
boolean answerIsTrue = mQuestionBank[mCurrentIndex] .isAnswerTrue(); 


int messageResId = 0; 


if (userPressedTrue == answerIsTrue) { 
messageResId = R.string.correct toast; 
} else{ 


messageResId = R.string.incorrect toast; 


} 


Toast.makeText(this, messageResId, Toast.LENGTH SHORT) 
.Show(); 


} 
在 按钮 的 监听 器 里 ， 调 用 checkAnswer(bootLean) 方 法 ， 如 代码 清单 2-11 所 示 。 





代码 清单 2-11 调用 checkAnswer (boolean) 方 法 ( QuizActivity.java ) 
public class QuizActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


mTrueButton = (Button) findViewById(R.id.true button); 
mTrueButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Toast.makeText(QuizActivity.this, 
Rstring.correct toast, 
Toast.LENGTH_SHORT) .showO; 
checkAnswer (true); 
} 
}); 


mFalseButton = (Button) findViewById(R.id.false button); 
mFalseButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
A . 
让 Y t_ 
Toeast.LENGTH_SHORT) show 


checkAnswer (false); 


}); 


} 
GeoQuiz 应 用 可 以 运行 了 ， 这 次 ， 我 们 要 在 物理 设备 上 运行 它 。 
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2.5 在 物理 设备 上 运行 应 用 
本 节 ， 我 们 学 习 如 何 设置 系统 、 设 备 和 应 用 ， 实 现在 硬件 设备 上 运行 GeoQuiz 应 用 。 


2.5.1 连接 设备 


首先 ， 将 设备 连接 到 系统 上 。Mac 系 统 应 该 会 立即 识别 出 所 用 设备 。 如 果 是 Windows 系 统 ， 
则 可 能 需要 安装 adb ( Android Debug Bridge ) 驱动 。 如 果 Windows 系 统 自 身 无 法 找到 adb 驱 动 ， 请 
到 设备 生产 商 的 网 站 下 载 。 


2.5.2 ”配置 设备 用 于 应 用 开发 


要 在 设备 上 测试 应 用 ， 首 先 应 打开 设备 的 USB 调 试 模式 。 

开发 者 选项 默认 不 可 见 。 先 选择 “ 设 定 一 关于 平板 /手机 ”项 , 再 点 击 版 本 号 (Build Number ) 
7 次 启用 它 ， 然 后 回 到 “ 设 定 ” 项 ， 选 择 “ 开 发 ”项 ， 找 到 并 勾 选 “USB 调 试 ”选项 。 

不 同 版 本 设备 的 设置 方法 杀 异 。 如 果 在 设置 过 程 中 过 到 问题 ， 请 访问 以 下 网 页 求助 : 
http://developer.android.com/tools/device.html。 

可 打开 Devices 视 图 确认 设备 是 否 已 识别 。 选 择 Android Studio 底 部 的 Android Monitor 工 具 窗 
口 ， 可 快速 打开 Devices 视 图 。 设 备 连 接 成 功 的 话 ， 你 会 看 到 已 连接 设备 的 下 拉 列 表 。AVD 以 及 
硬件 设备 应 该 就 列 在 其 中 ， 如 图 2-7 所 示 。 












































Android Monitor 
曙 Emulator Nexus_5X_API_24 Android 7.0, API 24 1? 


Is] iialogcat Monitors 于 
加 一 
出 [ 09- 
凶 | HostC 
@ 09-01 15:40:26.311 2861-2861/? W/art: Before A 
会 ”09-01 15:40:26.398 2861-2861/? W/gralloc_ranch 
@ | 
? 写 


09-01 15:40:26.655 2861-2876/com.bignerdranch 
89-01 15:40:26.655 2861-2876/com.bignerdranch. 


D4:Run 外 TODO 局 6:Android Monitor 加 Terminal 
图 2-7 查看 已 连接 设备 


如 果 设 备 无 法 识别 ， 请 首先 确认 是 否 已 打开 设备 和 开发 者 选项 。 如 果 仍 然 无 法 解决 ， 请 访 
问 Android 开 发 网 站 http://developer.android.com/tools/device.html ， 或 访问 本 书 论坛 http://forums. 
bignerdranch.com 求 助 。 
再 次 运行 GeoQuiz 应 用 ，Android Studio 会 询问 是 在 虚拟 设备 还 是 物理 设备 上 运行 应 用 。 选 择 
物理 设备 并 继续 。 稍 等 片刻 ，GeoQuiz 应 用 应 该 已 经 在 设备 上 运行 了 。 
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如 果 Android Studio 没 有 给 出 选项 ， 应 用 依然 在 虚拟 设备 上 运行 ， 请 按 以 上 步骤 重新 检查 设 
备 设置 ， 并 确保 设备 与 系统 已 正确 连接 。 然 后 ， 再 检查 运行 配置 是 否 有 问题 。 要 修改 运行 配置 ， 
请 选择 Android Studio 窗 口 靠近 顶部 的 app 下 拉 列 表 ， 如 图 2-8 所 示 。 


























GeoQuiz - 
[appv| 人 菲 心 革 ， 


2 Edit Configurations... 


[& app 





图 2-8 ”打开 运行 配置 








选择 Edit Configurations... 打 开 运 行 配置 编 辑 窗 口 ， 如 图 2-9 所 示 。 


®© 【2 Run/Debug Configurations 

















+- 了 国 多 和 < 了 器 Name: ‘app Share 


Y [2Android App 
ER Miscellaneous Debugger Profiling 





[sapp 
FDefaults le Pap 日 
Installation Options 
Deploy: Default APK 日 
Install Flags: |Options to ‘pm install' command 
Launch Options 
Launch: ”Default Activity 如 
Launch Flags: [Options to ‘am start' command 
Deployment Target Options 
Target: 1 Open Select Deployment Target Dialog > 
Use same device for future launches 
™ Before launch: Gradle-aware Make, Activate tool window 
局 Gradle-aware Make 
? Cancel Appy 7 


图 2-9 ”运行 配置 界面 


选择 窗口 左边 区 域 的 app ,确认 已 选中 Deployment Target Options 区 域 的 Open Select 
Deployment Target Dialog 选 项 。 点击 OK 按钮 并 重新 运行 应 用 , 现在 应 能 看 到 可 以 运行 应 用 的 设备 
选项 了 。 


2.6 添加 图 标 资 源 
GeoQuiz 应 用 现在 已 经 可 用 了 。 如 果 NEXT 按 钮 上 能 够 显示 向 右 的 图 标 ， 用 户 界 面 看 起 来 应 





本 书 随 书 文件 中 提供 了 这 样 的 箭头 图 标 (https://www.bignerdranch.com/solutions/Android 
Programming3e.zip )。 随 书 文 件 集合 了 Android Studio 项 目 文件 ， 每 章 对 应 一 个 项 目 文件 。 
下 载 随 书 文件 ， 找 到 并 打开 02 MVC/GeoQuiz/app/src/main/res 目 录 。 在 该 日 录 下 ， 可 以 看 到 
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drawable-mdpi、drawable-hdpi、drawable-xhdpi 和 drawable-xxhdpi 四 个 目录 。 
四 个 目录 各 自 的 后 缀 名 代表 设备 的 像素 密度 。 

口 mdpi: 中 等 像素 密度 屏幕 ( 约 160dpi )。 

口 hdpi: 高 像素 密度 屏幕 ( 约 240dpi )。 

口 xhdpi: 超 高 像素 密度 屏幕 ( 约 320dpi )。 

口 xxhdpi: 超 超 高 像素 密度 屏幕 ( 约 480dpi )。 

(另外 还 有 ldpi 和 和 xxxhdpi 这 两 个 本 书 用 不 到 的 类 别 ， 因 此 ， 未 包括 在 内 。 ) 

每 个 目录 下 ， 有 两 个 图 片 文件 : arrow_right.png 和 arrow_left.png。 这 些 图 片 文件 都 是 按照 上 日 
录 名 对 应 的 dpi 定 制 的 。 

GeoQuiz 项 目 中 的 所 有 图 片 资 源 都 会 随 应 用 安装 在 设备 里 , Android 操 作 系 统 知道 如 何 为 不 同 
设备 提供 最 佳 匹配 。 注 意 , 在 为 不 同 设备 准备 适 配 图 片 的 同时 ,应 用 安装 包容 量 也 随 之 增 大 。 当 
然 ， 对 于 GeoQuiz 这 样 的 小 项 目 ， 问 题 并 不 明显 。 

如 果 应 用 不 包含 设备 对 应 的 屏幕 像素 密度 文件 ， 在 运行 时 ，Android 系 统 会 自动 找到 可 用 的 
图 片 资源 , 针对 该 设备 进行 缩放 适 配 。 有 了 这 种 特性 , 就 不 一 定 要 准备 各 种 屏幕 像素 密度 文件 了 。 
因此 , 为 控制 应 用 包 的 大 小 ， 可 以 只 为 主流 设备 准备 分 辨 率 较 高 的 定制 图 片 资 源 。 至 于 那些 不 常 
见 的 低 分 状 率 设备 ， 让 Android 系 统 自 动 适 配 就 好 。 

〈 第 23 章 会 介绍 为 屏幕 像素 密度 定制 图 片 的 替代 方案 ， 另 外 ,还 会 解释 mipmap 目 录 的 用 途 。) 


2.6.1 向 项 目 中 添加 资源 


接 下 来 ， 需 将 图 片 文件 添加 到 GeoQuiz 项 目 资源 中 去 。 
首先 ， 确 认 打开 了 Android Studio 的 Project 视 图 ( 打开 方式 请 参见 图 1-13 )。 展 开 GeoQuiz/ 
app/src/main/res 目 录 ， 会 看 到 名 为 mipmap-hdpi 和 mipmap-xhdpi 这 样 的 目录 ， 如 图 2-10 所 示 。 

































































Packages | Bl- Scratches | 上 四 幸 | 鬼 - 及 
忒 GeoQuiz /Users/dev/AndroidStudioProjects/GeoQuiz 
襄 .gradle 
口 .idea 
app 
户 build 
口 libs 
四 src 
品 androidTest 
记 main 
口 java 
res 
加 drawable 
本 layout 
加 mipmap-hdpi 
名 mipmap-mdpi 
mipmap-xhdpi 
mipmap-xxhdpi 
mipmap-xxxhdpi 





图 2-10 ”还 缺 各 类 drawable 目 


UL 
洒 
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在 随 书 文件 中 ， 选 择 并 复制 drawable-mdpi、drawable-hdpi、drawable-xhdpi 和 drawable-xxhdpi 
这 四 个 目录 。 然 后 粘贴 到 Android Studio 的 app/src/main/res 目 录 中 。 完 成 后 ， 在 Android Studio 的 项 
目 工 具 窗 口 ， 就 可 以 看 到 这 四 个 目录 ， 每 个 目录 当中 含有 对 应 的 arrow_left.png 和 arrow_right.png 
文件 ， 如 图 2-11 所 示 。 





站 | packages | 国 Scratches | kp 名 地 | 将- I+ 
了 [aGeoQuiz /Users/dev/AndroidStudioProjects/GeoQuiz 
上 癌 .gradle 
kk DD.idea 
7 加 app 
kk Dbuild 
口 libs 
了 src 
EF DandroidTest 
7 口 main 
F Djava 
" Cares 
和 本 drawable 
7 drawable-hdpi 
arrow_left.png 
arrow_right.png 
7 后 drawable-mdpi 
arrow_left.png 
arrow_right.png 
7 国 drawable-xhdpi 
arrow_left.png 
arrow_right.png 
r Ddrawable-xxhdpi 
arrow_left.png 
arrow_right.png 
EF layout 
EF mipmap-hdpi 


图 2-11 drawable 目 录 中 的 箭头 图 标 文 件 


如 果 将 项 目 工具 窗口 切换 回 Android 视 图 , 新 增加 的 drawable 图 片 资 源 会 以 图 2-12 所 示 的 形式 
展示 。 











Project Files | 4 四 过 | 亲 - I 
” Caapp 
> 站 manifests 
F Djava 
v Cares 
r drawable 
# arrow_left.png (4) 
» [Oarrow_right.png (4) 
> layout 
r 名 mipmap 
» 后 ic_launcher.png (5) 
> 后 values 


图 2-12 ”drawable 目 录 中 的 箭头 图 标 文 件 汇总 


向 应 用 添加 图 片 就 这 么 简单 。 任 何 添加 到 res/drawable 目 录 中 、 后 级 名 为 .png、.jpg 或 者 .gif 的 
文件 都 会 自动 获得 资源 ID。( 注意 ,文件 名 必须 是 小 写字 母 且 不 能 有 任何 空格 符号 。) 
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这 些 资源 ID 并 不 按照 屏幕 像素 密度 匹配 ， 因 此 不 需要 在 运行 的 时 候 确定 设备 的 屏幕 像素 密 
度 ， 只 需 在 代码 中 引用 这 些 资 源 ID 就 可 以 了 。 应 用 运行 时 ,操作 系统 知道 如 何在 特定 的 设备 上 显 
示 匹 配 的 图 片 。 

Android 资 源 系统 是 如 何 工作 的 ?从 第 3 童 起 ,我 们 会 深入 学 习 这 方面 的 相关 知识 。 现 在 ,能 
显示 右 箭头 图 标 就 可 以 了 。 


2.6.2 在 XML 文件 中 引用 资源 


在 代码 中 ， 可 以 使 用 资源 ID 引用 资源 。 如 果 想 在 布局 定义 中 配置 NEXT 按 钮 显示 箭头 图 标 ， 
又 该 如 何在 布局 XML 文件 中 引用 资源 呢 ? 

很 简单 ， 只 是 语法 稍 有 不 同 而 已 。 打 开 activity_quiz.xml 文 件 ， 为 Button 组 件 新 增 两 个 属 怕 
如 代码 清单 2-12 所 示 。 


代码 清单 2-12 ”为 NEXT 按 钮 增加 图 标 (activity_quiz.xml ) 


<LinearLayout ... > 









































PT 


<LinearLayout ... > 
</LinearLayout> 


<Button 
android:id="@+id/next button" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:text="@string/next_ button" 
android:drawableRight="@drawable/arrow_right" 
android:drawablePadding="4dp" /> 


</LinearLayout> 

在 XML 资源 文件 中 ， 通 过 资源 类 型 和 资源 名 称 ， 可 引用 其 他 资源 。 以 @string/ 开 头 的 定义 
是 引用 字符 串 资 源 。 以 edrawabtLe/ 开 头 的 定义 是 引用 drawable 资 源 。 

自 第 3 章 起 ， 我 们 还 会 学 习 更 多 资源 命名 以 及 res 目 录 结 构 中 其 他 资源 的 使 用 等 相关 知识 。 

运行 GeoQuiz 应 用 。 新 按钮 很 漂亮 吧 ? 测试 一 下 ， 确 认 它 仍然 工作 正常 。 

别 高 兴 得 太 早 ，GeoQuiz 应 用 有 个 bug。 应 用 运行 时 ， 单 击 NEXT 按 钮 显示 下 一 道 题 ， 然 后 旋 
转 设 备 。 如 果 是 模拟 器 ， 请 点 击 浮动 工具 栏 上 的 左旋 或 右 旋 按 钮 ， 如 图 2-13 所 示 。 
































OO 


图 2-13 ”控制 旋转 
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发 现 没 有 ， 设 备 旋转 后 ， 应 用 又 显示 了 第 一 道 测试 题 。 怎 么 回 事 ? 如 何 修正 ? 
要 解决 此 类 问题 ， 需 了 解 activity 生 命 周期 的 概念 。 第 3 章 会 专门 介绍 。 





2.7 ”挑战 练习 : 为 TextView 添加 监听 器 


NEXT 按 钮 不 错 ， 但 如 果 用 户 单 击 应 用 的 TextView 文 字 区 域 (地 理 知识 问题 )， 也 可 以 跳 转 
到 下 一 道 题 ， 用 户 体验 会 更 好 。 

















提示 TextView 也 是 View 的 子 类 ， 因 此 和 Button 一 样 ， 可 为 TextView 设 置 View.0nClick- 
Listener 监 听 器 。 


2.8 挑战 练习 : 添加 后 退 按钮 


为 GeoQuiz 应 用 新 增 后 退 按钮 (PREV )， 用 户 单 击 时 ， 可 以 显示 上 一 道 测试 题目 。 完 成 后 的 


用 户 界面 应 如 图 2-14 所 示 。 
A700 











TRUE FALSE 


《 PREV NEXT 》 








图 2-14 ”添加 了 后 退 按钮 的 用 户 界面 
这 是 个 很 棒 的 练习 ， 需 回顾 本 章 和 上 一 章 的 内 容 才能 完成 。 


2.9 挑战 练习 : 从 按钮 到 图 标 按钮 
如 果 前 进 与 后 退 按钮 上 只 显示 指示 图 标 ， 用 户 界面 更 清爽 ， 如 图 2-15 所 示 。 
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A700 
GeoQuiz 








Canberra is the capital of Australia 


TRUE FALSE 


2 








图 2-15 ”只 显示 图 标的 按钮 


要 完成 此 练习 ， 需 将 普通 的 Button 组 件 替 换 成 ImageButton 组 件 。 
ImageButton 组 件 继承 自 ImageView。Button 组 件 则 继承 自 TextView。ImageButton 和 
Button 与 View 间 的 继承 关系 如 图 2-16 所 示 。 




















! 继承 自 1 继承 自 
A A 
1 继承 自 1 继承 自 


图 2-16 ”ImageButton 和 Button 与 View 间 的 继承 关系 


如 以 下 代码 所 示 ， 以 ImageButton 组 件 蔡 换 Button 组 件 ， 删 除 NEXT 按 钮 的 text 以 及 
drawable 属 性 定义 ， 并 添加 ImageView 属 性 : 


<Button ImageButton 
android:id="@+id/next button" 
android:layout width="wrap_content" 
android: ye height= "wrap_content" 
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a | | bl Ri t="@d bl / [Fi ght" 


android:src="@drawable/arrow_right" 
/> 


当然 ， 为 了 使 用 ImageButton ， 还 要 调整 QuizActivity 类 的 代码 。 

将 Button 组 件 替 换 成 ImnageButton 后 ，Android Studio 会 警告 说 找 不 到 android:content- 
Description 属 性 定义 。 该 属性 能 为 视力 障碍 用 户 提供 方便 。 在 为 其 设置 文字 属性 值 后 ， 如 果 设 
备 的 可 访问 性 选项 作 了 相应 设置 ， 那 么 在 用 户 点 击 图 形 按钮 时 ， 设 备 便 会 读 出 属性 值 的 内 容 。 

最 后 ， 为 每 个 ImageButton 都 添加 上 android:contentDescription 属 性 定义 。 


















































第 3 章 


activity 的 生命 周期 村 | 











你 在 第 2 章 章 未 已 看 到 ， 只 要 一 旋转 设备 ， 地 理 知识 问题 就 回 到 第 一 道 初始 题 。 用 户 旋 转 设 
备 ， 应 用 状态 就 重 置 ， 是 什么 原因 呢 ? 要 想 搞 明白 ， 并 解决 这 类 常见 的 旋转 问题 ， 首 先 要 学 习 
activity 生 命 周 期 的 基础 知识 。 

每 个 Activity 实 例 都 有 其 生命 周期 。 在 其 生命 周期 内 ，activity 在 运行 、 暂 停 、 停 止 和 不 存 
在 这 四 种 状态 间 转 换 。 每 次 状态 转换 时 ， 都 有 相应 的 Activity 方 法 发 消息 通知 activity。 图 3-1 显 
示 了 activity 的 生命 周期 、 状 态 以 及 状态 切换 时 系统 调用 的 方法 。 



































不 存在 
onCreate(...) onDestroy( 
| (对 象 实例 在 内 存 中 ) 
onStart() onStop() | 
| 二 “可 视 生 命 周 期 


(视图 部 分 或 全 部 可 见 ) 





onResume() onPause() 





图 3-1 ”activity 的 状态 图 解 


内 存 中 有 没有 activity 的 实例 ， 用 户 是 否 看 得 到 ， 是 否 活 跃 在 前 台 ( 等 待 或 接受 用 户 输入 中 )， 
看 图 3-1 的 各 种 状态 就 知道 了 。 完 整 总 结 如 表 3-1 所 示 。 
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表 3-1 ”activity 的 状态 








状 态 有 内 存 实例 用 户 可 见 处 于 前 台 
不 存在 否 否 否 
停止 是 省 胆 
暂停 是 是 或 部 分 " 否 
运行 是 是 是 


* 某 些 场景 下 ， 和 暂停 状态 的 activity 可 能 会 部 分 或 完全 可 见 ， 详 见 3.1.3 节 。 


用 户 可 以 与 当前 运行 状态 下 的 activity 交 互 。 设 备 上 有 很 多 应 用 , 但 是 , 任何 时 候 只 能 有 一 个 
activity 处 于 用 户 能 交互 的 运行 状态 。 
借助 图 3-1 所 示 的 方法 ，Activity 的 子 类 可 以 在 activity 的 生命 周期 状态 发 生 关 键 性 转换 时 完 
成 某 些 工作 。 这 些 方 法 通常 被 称 为 生命 周期 回调 方法 。 

我 们 已 熟悉 这 些 方法 中 的 onCreate (Bundle) 方 法 。 在 创建 activity 实 例 后 ， 但 在 此 实例 出 现 
在 屏幕 上 之 前 ，Android 操 作 系 统 会 调用 该 方法 。 

通常 ， 通 过 和 窗 盖 onCreate (Bundle) 方 法 ，activity 可 以 预 处 理 以 下 UI 相关 工作 : 
口 实例 化 组 件 并 将 它们 放置 在 屏幕 上 (调用 setContentView(int) 方 法 ); 
口 引用 已 实例 化 的 组 件 ; 
口 为 组 件 设置 监听 器 以 处 理 用 户 交互 ; 
口 访问 外 部 模型 数据 。 
团 记 ， 千 万 不 要 自己 去 调用 onCreate(Bundle) 方 法 或 任何 其 他 activity 生 命 周 期 方法 。 为 通 
知 activity 状 态 变 化 ， 你 只 需 在 Activity 子 类 里 覆盖 这 些 方法 ，Android 会 适时 调用 它们 (看 当前 
用 户 状态 以 及 系统 运行 情况 )。 


3.1 日 志 跟 踪 理 解 activity 生命 周期 
本 节 ， 我 们 会 覆 六 一些 activity 生 命 周 期 方法 ， 以 此 一 从 究竟 ， 学 习 并 理解 QuizActivity 的 


生命 周期 。 这 些 履 盖 方 法 会 输出 日 志 , 告诉 我 们 操作 系统 何 时 调用 了 它们 。 这样, 伴随 用 户 操 作 ， 
QuizActivity 的 状态 如 何 变化 ， 就 很 清楚 了 。 
3.1.1 输出 日 志 信息 

Android 的 android.utilL.Log 类 能 够 向 系统 级 共享 日 志 中 心 发 送 日 志 信 息 。Log 类 有 好 几 个 
日 志 记 录 方 法 。 本 书 用 得 最 多 的 是 以 下 方法 : 

public static int d(String tag, String msg) 


d 代 表 “debug”, 用 来 表示 日 志 信 息 的 级 别 。( 本 章 最 后 一 节 会 详细 讲解 有 关 Log 级 别 的 内 容 。) 
第 一 个 参数 是 日 志 的 来 源 ， 第 二 个 参数 是 日 志 的 具体 内 容 。 
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该 方法 的 第 一 个 参数 通常 以 类 名 为 值 的 TAG 常量 传 和 人。 这样, 就 很 容易 看 出 日 志 信 息 的 来 源 。 
在 QuizActivityjava 中 ， 为 QuizActivity 类 新 增 一 个 TAG 常量 ， 如 代码 清单 3-1 所 示 。 


代码 清单 3-1 ”新 增 一 个 TAG 常量 (QuizActivityjava ) 
public class QuizActivity extends AppCompatActivity { | 
private static final String TAG = "QuizActivity"; 
} 


然后 ， 在 onCreate(Bundle) 方 法 里 调用 Log.d(,. . ) 方 法 记录 日 志 ， 如 代码 清单 3-2 所 示 。 
代码 清单 3-2 为 onCreate (Bundle) 方 法 添加 日 志 输 出 代码 ( QuizActivity.java ) 


public class QuizActivity extends AppCompatActivity { 





@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate(Bundle) called"); 
setContentView(R.layout.activity quiz); 


} 
接 下 来 ， 在 QuizActivity 类 的 onCreate (Bundle) 之 后 ， 禾 盖 其 他 五 个 生命 周期 方法 ， 如 
代码 清单 3-3 所 示 。 


代码 清单 3-3 ”覆盖 更 多 生命 周期 方法 ( QuizActivity.java ) 


public class QuizActivity extends AppCompatActivity { 





@Override 
protected void onCreate(Bundle savedinstanceState) { 


} 


@Override 
public void onStart() { 
super.onStart(); 
Log.d(TAG, "onStart() called"); 
} 


@Override 
public void onResume() { 
super.onResume(); 
Log.d(TAG, "onResume() called"); 
} 


@Override 
public void onPause() { 
super .onPause(); 
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Log.d(TAG, "onPause() called"); 
} 


@Override 
public void onStop() { 
super.onStop(); 
Log.d(TAG, "onStop() called"); 
} 


@Override 
public void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy() called"); 


} 

注意 , 我 们 先是 调用 了 超 类 的 实现 方法 ,然后 才 调 用 具体 的 日 志 记 录 方 法 。 这 些 超 类 方法 的 
调用 不 可 或 缺 。 从 以 上 代码 可 以 看 出 ,在 回调 履 盖 实现 方法 里 ， 超 类 实现 方法 总 在 第 一 行 调用 。 
也 就 是 说 ， 应 首先 调用 超 类 实现 方法 ， 然 后 再 调用 其 他 方法 。 

知道 为 什么 要 使 用 Ge0verride 注 解 吗 ? 使 用 0verride 注 解 ， 就 是 要 求 编译 需 保 证 当前 类 
有 你 要 履 盖 的 方法 。 例 如 ， 对 于 如 下 拼写 错误 的 方法 ， 编 译 器 会 发 出 警告 


public class QuizActivity extends AppCompatActivity { 
































@Override 
public void onCreat(Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 


Ww 
AppCompatActivity 父 类 没有 onCreat (Bundle) 方 法 , 因此 编译 器 发 出 了 敬告。 这样 ,你 就 
能 及 时 改正 拼写 错误 ， 而 不 是 等 到 应 用 运行 时 ， 才 发 现 奇怪 的 现象 ， 再 去 查找 问题 在 哪 。 








3.1.2 ”使 用 LogCat 


应 用 运行 时 ， 可 以 使 用 LogCat 工 具 查 看 日 志 。LogCat 是 Android SDK 工 具 中 的 一 款 日 志 查 
看 需 。 

运行 GeoQuiz 应 用 时 ， 应 该 能 在 Android Studio 底 部 看 见 LogCat， 如 图 3-2 所 示 。 如 果 看 不 到 ， 
请 切换 至 Android Monitor 工 具 窗口 模 式 ， 并 确保 已 选中 logcat 选 项 页 。 

运行 GeoQuiz 应 用 ， 立 刻 可 看 到 LogCat 窗 口中 的 各 类 混杂 信息 。 这 些 日 志 中 ， 有 些 是 以 应 用 
包 名 为 默认 名 的 应 用 类 信息 ， 有 些 是 系统 输出 信息 。 

为 方便 查找 ， 可 使 用 TAG 常 量 过 滤 日 志 输出 。 单 击 LogCat 面 板 右 上 角 写 着 Show only selected 
application 的 下 拉 列 表 。 ee a 当前 选项 控制 只 显示 来 自 应 用 的 日 志 信息 。 如 果 
选 No Filters ， 则 会 看 到 系统 的 所 有 输出 信息 。 
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5 | @ 5 Question 
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a » 加 com.bignerdranch.android.geoquiz (androidTest) 
NI 
了 > com.bignerdranch.android.geoquiz (tesb 
» Cares 
sr (©$ Gradle Scripts 
3 
Pe 
es Nexus SX_API 24 Android 7.0, API 24 com.bignerdranch.android.geoquiz (10353) 目 
3 a 
昌国 Verbose Q- Regex 。 Show only selected application 
和 面 | 傅 239 16353-19353/? I/art: Not late-enabling -Xcheck:jni (already on) 
如 里 ,249 109353-19353/? W/art: Unexpected CPU variant for X86 using defaults: x86 
声 | 40.328 10353-19353/com.bignerdranch,.android.geoquiz W/System: ClassLoader referenced unknown path: /data/app/com.bignerdranch.android.geoquiz 
Cy Da [ 09-06 11:04:40.335 1522: 1545 D/ ] 4 
兰 I lostConnection: :get lost Connection established 9x8afcec80，t: a 
© HostCt i () New Ht C iol blished Ox8afcec80, tid 1545 3 
5 | 909-06 11:04:49.369 10353-10353/com.bignerdranch.android,.geoquiz W/art: Before Android 4.1, method android.graphics.PorterDuffColorFilter android.support. 3 
?7 | 写 09-06 11:04:46.373 10353-10353/com.bignerdranch.android,geoquiz D/QuizActivity: onCreate(Bundte) called a 
| 99-06 11:04:40,420 10353-19353/com.bignerdranch.android,geoquiz D/QuizActivity: onStart() called 加 
语 | 99-96 11 46.423 10353-19353/com.bignerdranch.android.geoquiz D/QuizActivity: onResume() called 全 
i :84:40.436 19353-19353/com.biqnerdranch.android,qeoquiz W/qralloc ranchu: Gralloc pipe failed 
4:Run Terminal 0: Messages EventLog ” 国 Gradle Console 
国 画 曙 2 国 
国 Gradle build finished in 4s 440ms (a minute ago) 8:29 n/a n/a Context:<nocontext> “ 古 量 


图 3-2” Android Studio 中 的 LogCat 


要 创建 过 滤 设 置 ， 选 择 Edit Filter Configuration 选 项 。 单 击 绿色 + 按钮 ,创建 一 个 消息 过 滤器 。 
在 Filter Name 处 输入 QuizActivity，Log Tag 人 处 同样 输入 QuizActivity， 如 图 3-3 所 示 。 




















@e® Create New Logcat Filter 
十 一 Filter Name: | QuizActivity 
ET Specify one or several filtering parameters: 
| Log Tag: Qr QuizActivity 四 回 Regex 
:Log Message Q- Regex 
Package Name: Q- Regex 
PID: | | 
Log Level: Verbose 四 


ca 攻 忆 司 
图 3-3 ”在 LogCat 中 创建 过 滤器 
单 击 OK 按 钮 。 现 在 ，LogCat 和 窗口 仅 显 示 Tag 为 QuizActivity 的 日 志 信 息 ， 如 图 3-4 所 示 。 





if¥ logcat Monitors = 








Verbose QO- 加 Regex QuizActivity 3 


全 09-06 11:04:40.373 10353-10353/com.bignerdranch,android.geoquiz D/QuizActivity: onCreate(Bundle) called 
09-06 11:04:40.426 10353-10353/com.bignerdranch.android.geoquiz D/QuizActivity: onStart() called 
加 ”9%9-86 11:04:40.423 10353-10353/com.bignerdranch,android,.geoquiz D/QuizActivity: onResume() called 


» 











图 3-4 ”应 用 启动 后 ， 被 调用 的 三 个 生命 周期 方法 
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3.1.3 activity 生命 周期 实例 解析 


如 图 3-4 所 示 ，GeoQuiz 应 用 启动 并 创建 QuizActivity 初 始 实 例 后 ，onCreate (Bundle)、 
onStart() 和 onResume() 这 三 个 生命 周期 方法 被 调用 了 。QuizActivity 实 例 现在 处 于 运行 状态 
(在 内 存 里 ， 用 户 可 见 ， 活 动 在 前 台 )。 

( 如 果 看 不 到 过 滤 后 的 信息 列表 , 请 选择 LogCat 过 滤器 下 拉 列 表 中 的 QuizActivity 过 波 项 。) 

下 面 我 们 来 做 个 有 趣 的 实验 。 在 设备 上 单 击 后 退 键 ， 再 查看 LogCat。 可 以 看 到 ， 日 志 显 示 
QuizActivity 的 onPause() 、onStop() 和 onDestroy() 方 法 被 调用 了 ， 如 图 3-5 所 示 。 
QuizActivity 实 例 处 于 不 存在 的 状态 (不 在 内 存 里 ， 显 然 不 可 见 ， 自 然 不 会 活动 在 前 台 )。 
































i logcat Monitors + verbose 加 国 Regex | QuizActivity 回 





09-06 11:064:40.373 10353-10353/com.bignerdranch.android,.geoquiz D/QuizActivity: onCreate(Bundle) called 
09-06 11:04:40.420 10353-10353/com.bignerdranch.android.geoquiz D/QuizActivity: onStart() called 

09-06 11:04:40,423 10353-10353/com,bignerdranch.android,geoquiz D/QuizActivity: onResume() called 
09-06 11:28:06.720 10353-10353/com.bignerdranch.android.geoquiz D/QuizActivity: onPause() called 

09-06 11:28:07.296 10353-10353/com,bignerdranch.android,geoquiz D/QuizActivity: onstop() called 

09-06 11:28:07.296 10353-10353/com.bignerdranch.android,.geoqguiz D/QuizActivity: onDestroy() called 


BF 和 =| 


图 3-5 单 击 后 退 键 销毁 activity 


单 击 设备 的 后 退 键 ， 相 当 于 告诉 Android 系 统 : “activity 已 用 完 ， 现在 不 需要 它 了 。” 随 即 ， 
系统 就 销毁 了 该 activity 的 视图 及 其 内 存 里 的 相关 信息 。 这 实际 是 Android 系 统 节约 使 用 设备 有 限 
资源 的 一 种 方式 。 
点 击 GeoQuiz 应 用 图 标 ， 再 次 运行 它 。 日 志 显 示 ，Android 创 建 了 全 新 的 QuizActivity 实 例 ， 

然后 调用 onCreate() 、 onStart() 和 onResume() 方 法 。QuizActivity 从 不 存在 变 为 运行 状态 。 

现在 ， 单 击 主屏 幕 键 ， 随 即 ， 主 屏 界面 出 现 了 ，QuizActivity 视 图 不 见 了 。QuizActivity 
处 于 啥 状态 呢 ? 查看 LogCat， 可 以 看 到 系统 调用 了 QuizActivity 的 onPause() 和 onStop () 方 
法 ,但 并 没有 调用 onDestroy() 方 法 ， 如 图 3-6 所 示 。 
































i logcat. Monitors 天 verbose 加 ac- Regex QuizActivity 加 


09-66 11:31:21.013 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onCreate(Bundle) called 
09-06 11:31:21.053 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onstart() called 

09-96 11:31:21.055 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onResume() called 
09-06 11:31:48.716 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onPause() called 

09-66 11:31:48.874 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onStop() called 


* 中 | 辐 | 即 


图 3-6 单 击 主屏 幕 键 停止 activity 


单 击 主屏 幕 键 ， 相 当 于 告诉 Android 系 统 :“ 我 去 别处 看 看 ， 稍 后 可 能 回来 。” 此 时 ，Android 
系统 会 先 暂 停 ， 再 停止 当前 activity。 这 表明 ，QuizActivity 实 例 已 处 于 停止 状态 ( 在 内 存 中 ， 
但 不 可 见 ， 不 会 活动 在 前 台 )。 这 样 ，Android 系 统 就 能 快速 响应 ， 重 启 QuizActivity， 回 到 用 
户 离开 时 的 状态 。 

(需要 注意 的 是 ， 停 止 的 activity 能 够 存在 多 久 ， 谁 也 无 法 保证 。 系 统 需要 回收 内 存 时 ， 它 将 
首先 销毁 那些 停止 的 activity。) 
现在 ,我 们 调 出 设备 的 概览 屏 。 如 果 是 比较 新 的 设备 ， 可 单 击 主屏 幕 键 旁 的 最 近 应 用 键 ， 调 
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出 概览 屏 ， 如 图 3-7 所 示 。( 如 果 设 备 没有 最 近 应 用 键 ， 则 长 按 主屏 幕 键 调 出 概览 屏 。) 
大 | 


Email Gallery 

















图 3-7 主屏 幕 键 、 后 退 键 以 及 最 近 应 用 键 


概览 屏 的 每 张 卡片 代表 用 户 之 前 交互 过 的 一 个 应 用 ,如 图 3-8 所 示 。( 用 户 常 把 概览 屏 称 作 最 
近 应 用 屏 或 任务 管理 器 。 不 过 ， 既 然 Google 开 发 者 文档 将 其 称 作 概览 屏 ， 本 书 从 之 。) 


























站 ”BeatBox 


65_CJIPIE 66_INDIOS 67_INDIOS2 


全 criminallntent 
Scooter stolen while going to the restroom 
Sun 0ct 30 21:16:28 EDT 2016 


Paper clip ponzi scheme 
Sun Oct 30 21:16:42 EDT 2016 


Instagram photos at beach on "sick day" 
Sun Oct 30 21:16:55 EDT 2016 


Fragment fraud 


和 GeoQuiz 











图 3- 8 概览 屏 


在 概览 屏 中 ， 单 击 GeoQuiz 应 用 ，QuizActivity 视 图 随即 出 现 。 
LogCat 日 志 显 示 ， 系 统 没 有 调用 onCreate() 方 法 ( 因为 Activity 实 例 还 在 内 存 里 ， 自 然 不 
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用 重建 了 )， 而 是 调用 了 onstart() 和 onResume () 方 法 。 用 户 按 了 主屏 幕 键 后 ，QuizActivity 
最 后 进入 停止 状态 ， 再 次 调 出 应 用 时 ，QuizActivity 只 需要 重新 启动 (进入 暂停 状态 ， 用 户 可 
见 )， 然 后 继续 运行 (进入 运行 状态 ， 活 动 在 前 台 )。 

activity 有 时 也 会 一 直 处 于 暂停 状态 〈( 用户 完全 或 部 分 可 见 ， 但 不 在 前 台 )。 可 能 出 现 部 分 可 
见 暂 停 状态 的 场景 在 一 个 activity 之 上 启动 带 透 明 背 景 视图 或 小 于 屏幕 尺寸 视图 的 新 activity 时 。 
可 能 出 现 完全 可 见 暂 停 状态 的 场景 应 用 多 窗口 模式 下 ( Android 6.0 及 更 高 系统 版 本 才 支持 )， 
当前 activity 在 一 个 窗口 完全 可 见 ， 而 用 户 在 不 包含 当前 activity 的 男 一 个 窗口 操作 时 。 

在 本 书 的 后 续 学 习 过 程 中 ,为 完成 各 种 现实 任务 ,我 们 还 会 覆盖 一 些 其 他 生命 周期 方法 , 进 
一 步 学 习 更 多 生命 周期 方法 的 用 法 。 


3.2 ”设备 旋转 与 activity 生命 周期 


现在 ， 可 以 处 理 第 2 章 结束 时 发 现 的 应 用 缺陷 了 。 启 动 GeoQuiz 应 用 ， 单 击 NEXT 按 钮 显示 第 
二 道 地 理 知识 问题 ， 然 后 旋转 设备 。( 模拟 器 的 旋转 ， 使 用 Command+ 右 方向 键 /Ctrl+ 右 方向 键 ， 
或 点 击 工具 栏 上 的 旋转 按钮 。) 

设备 旋转 后 ，GeoQuiz 应 用 又 回 到 了 第 一 道 问 题 。 查 看 LogCat 日 志 看 看 发 生 了 什么 ， 如 图 3-9 
所 示 。 
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WE logcat | Monitors 二 verbose 加 cr- Regex QuizActivity 加 





09-06 11:34:12,302 16024-16024/com,bignerdranch,android,geoquiz D/QuizActivity: onStart() called 

09-06 11:34:12.302 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onResume() called 
09-06 11:34:22.837 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onPause() called 

09-06 11:34:22.858 16024-16024/com,bignerdranch.android,geoquiz D/QuizActivity: onStop() called 

09-06 11:34:22.858 16024-16024/com.bignerdranch.android,geoquiz D/QuizActivity: onDestroy() called 
09-06 11:34:22,900 16024-16024/com,bignerdranch.android,geoquiz D/QuizActivity: onCreate(Bundle) called 
09-06 11:34:22.910 16024-16024/com.bignerdranch.android.geoquiz D/QuizActivity: onStart() called 

09-06 11:34:22.911 160624-16824/com.bignerdranch.android.geoquiz D/QuizActivity: onResume() called 


+ =) 


图 3-9 QuizActivity 已 死 ，QuizActivity 万 岁 


设备 旋转 时 ， 系 统 会 销毁 当前 QuizActivity 实 例 ， 然 后 创建 一 个 新 的 QuizActivity 实 例 。 
再 次 旋转 设备 ， 又 一 次 见证 这 个 销毁 与 再 创建 的 过 程 。 

这 就 是 问题 所 在 。 每 次 旋转 设备 , 当前 QuizActivity 实 例会 完全 销毁 , 实例 中 的 mCurrent- 
Index 当 前 值 会 从 内 存 里 被 抹 掉 。 旋转 后 , Android 重 新 创建 了 QuizActivity 新 实例 , mCurrent- 
Index 在 onCreate(Bundte) 方 法 中 被 初始 化 为 9。 一 切 重 头 再 来 ， 用 户 又 看 到 第 一 道 题 。 

稍 后 会 修正 这 个 缺陷 。 不 要 停留 在 问题 表面 , 接 下 来 , 由 表 及 里 , 深入 分 析 为 什么 有 此 问题 。 


设备 配置 与 备 选 资源 

旋转 设备 会 改变 设备 配置 ( device configuration )。 设 备 配 置 实际 是 一 系列 特征 组 合 ， 用 来 描 
述 设备 当前 状态 。 这 些 特征 有 : 屏幕 方向 、 屏 幕 像素 密度 、 屏 幕 尺 寸 、 键 盘 类 型 、 底 座 模式 以 及 
语言 等 。 


通常 ， 为 匹配 不 同 的 设备 配置 ,应 用 会 提供 不 同 的 备 选 资源 。 为 适应 不 同 分 辩 率 的 屏幕 ,向 
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项 目 添 加 多 套 箭头 图 标 就 是 这 样 一 个 使 用 案例 。 

设备 的 屏幕 像素 密度 是 个 固定 的 设备 配置 ,无 法 在 运行 时 发 生 改 变 。 然而 , 屏幕 方向 等 特征 
可 以 在 应 用 运行 时 改变 。 

在 运行 时 配置 变更 (runtime configuration change ) 发 生 时 ， 可 能 会 有 更 合适 的 资源 来 匹配 新 
的 设备 配置 。 于 是 ，Android 销 毁 当 前 activity， 为 新 配置 寻找 最 佳 资源 ， 然 后 创建 新 实例 使 用 这 
些 资源 。 眼 见 为 实 ， 下 面 为 设备 配置 变更 新 建 备 选 资 源 ， 只 要 设备 旋转 至 水 平方 位 ，Android 就 
会 自动 发 现 并 使 用 它 。 

创建 水 平 模式 布局 

在 项 目 工 具 窗 口中 ， 碳 键 单 击 res 目 录 后 选择 New 一 Android resource directory 菜 单项 。 创 建 资 
源 目录 界面 列 出 了 资源 类 型 及 其 对 应 的 资源 特征 ， 如 图 3-10 所 示 。 从 资源 类 型 (Resource type ) 
列表 中 选择 layout， 保 持 Source set 的 main 选 项 不 变 。 


【2 图 New Resource Directory 





















































Directory name: layout 


Resource type: layout ?| 
Source set main 岛 
Available qualifiers: Chosen qualifiers: 


@ Country Code 

@ Network Code 

© Locale 

轴 Layout Direction 

加 Smallest Screen Width 

国 Screen width 

加 Screen Height 

马 Size 

加 | Ratio << 
| Orientation 
轩 Ul Mode 

加 Night Mode 

蕊 Density 

FTouch Screen 

豆 Keyboard 

品 Text Input 











图 3-10 ”创建 新 的 资源 目录 

接 下 来 选中 待 选 资源 特征 列表 中 的 Orientation ， 然 后 单 击 >> 按 钮 将 其 移动 至 已 选 资源 特征 
( Chosen qualifiers ) 区 域 。 

最 后 ， 确 认 选 中 Screen orientation 下 拉 列 表 中 的 Landscape 选 项 ， 并 确保 目录 名 ( Directory 
name ) 显示 为 jayout-land， 如 图 3-11 所 示 。 这 个 窗口 看 起 来 有 模 有 样 ， 但 实际 用 途 仅 限 于 设置 目 
录 名 。 点 击 OK 按钮 让 Android Studio 创 建 res/layout-land。 

这 里 的 -land 后 缀 名 是 配置 修饰 符 的 另 一 个 使 用 例子 。Android 依 靠 res 子 目录 的 配置 修饰 符 定 
位 最 佳 资源 以 匹配 当前 设备 配置 。 访 问 Android 开 发 网 页 http:/developerandroid.comy/guide/topics/ 
resources/providing-resources.html， 可 查看 Android 的 配置 修饰 符 列表 及 其 代表 的 设备 配置 信息 。 

设备 处 于 水 平方 向 时 ，Android 会 找到 并 使 用 res/layout-land 目 录 下 的 布局 资源 。 其 他 情况 下 ， 
它 会 默认 使 用 res/layout 目 录 下 的 布局 资源 。 然 而 ， 目 前 在 res/layout-land 目 录 下 并 没有 布局 资源 。 
让 我 们 解决 这 个 问题 。 
































54 第 3 章 activity 的 生命 周期 





© 9® 
Directory name: layout-land 
Resource type: layout 


Source set: main 


Available qualifie... 


@ Network Code 
© Locale 

加 Layout Directiol 
加 Smallest Screen 
区 Screen Width 

罩 Screen Height 
局 Size 

园 Ratio << 


>> 


加 Night Mode 

大 Density 

®t Touch Screen 
忆 Keyboard 

男 Text Input 

加 Navigation Statl 


BB Navioarinn_ Mori 


2 


图 3-11 


New Resource Directory 


Chosen qualifiers: Screen orientation 


@ Country Code Landscape 


Cancel Ww 


创建 res/layout-land 





从 res/layout 目 录 复制 activity_quiz.xml 文 件 至 res/layout-land 目 录 。( 如 果 在 Android 工 具 窗 口 看 
不 到 res/layout-land 目 录 , 请 从 Android 视 图 切换 到 Project 视 图 。 完 成 后 ,记得 切 回 。 如 果 喜 欢 , 你 
也 可 以 直接 使 用 文件 管理 器 或 终端 应 用 复制 粘贴 文件 。) 

现在 我 们 有 了 一 个 水 平 模式 布局 以 及 一 个 默认 布局 ( 竖 直 模式 )。 注 意 ， 两 个 布局 文件 的 文 
件 名 必须 相同 ， 这 样 它们 才能 以 同一 个 资源 ID 被 引用 。 

为 了 与 默认 的 布局 文件 相 区 别 ， 还 需 修 改 水 平 模式 布局 文件 。 请 参照 图 3-12 进 行 相应 修改 。 














“Gy 


N 


FrameLayout 
xmlns:android= "http://schemas.android.com/apk/res/android 


android:layout_width="match_parent" 





android:layout_height="match_parent" 


TextView 
android:id="@ +id/question_text_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:padding="24dp" 





android:layout_width="wrap_content" 
android:layout_height="wrap_content" 


android:layout_gravity= 
"center_vertical | center_horizontal" 





android:orientation="horizontal" 


| Button 


LinearLayout android:id="@+id/next_button" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom | right" 
android:text="@string/next_button" 
android:drawableRight="@drawable/arrow_right" 





| ' android:drawablePadding="4dp" 





图 3-12 


备 选 的 水 平 模式 布局 





邮 
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如 图 3-12 所 示 ，FrameLayout 替 换 了 最 上 层 的 LinearLayout 。FrameLayout 是 最 简单 的 
ViewGroup 组 件 , 它 一 概 不 管 如 何 安 排 其 子 视图 的 位 置 。FrameLayout 子 视图 的 位 置 排 列 取决 于 


它们 备 自 的 android:layout gravity 








E: 


量 


下 | 
可 [e] 


因而 ,TextView、LinearLayout 和 Button 都 需要 一 个 android:Layout gravity 属 性 。 这 
里 ，LinearLayout 里 的 Button 子 元 素 保 持 不 变 。 
参照 图 3-12, 打开 layout-land/activity_quiz.xml 文 件 修 改 。 完 成 后 可 同 代码 清单 3-4 做 对 比 检查 。 


代码 清单 3-4 





水 平 模式 布局 修改 (layout-land/activity quiz.xml ) 

















<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout_width="match_parent" 
android:layout_ height="match_ parent" > 


<TextView 


android:id="@+id/question text View" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center_horizontal" 


android:padding="24dp" /> 


<LinearLayout 


android:layout width="wrap content" 

android:layout height="wrap_ content" 

android:layout_ gravity="center_vertical|center_horizontal" 
android:orientation="horizontal" > 


</LinearLayout> 


<Button 


android:id="@+id/next button" 

android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout_gravity="bottom|right" 
android:text="@string/next button" 
android:drawableRight="@drawable/arrow right" 
android:drawablePadding="4dp" 


pe 


</LinearLayeut> 


</FrameLayout> 











再 次 运行 GeoQuiz 应 用 。 旋 转 设备 至 水 平方 位 ， 查 看 新 的 布局 界面 ， 如 图 3-13 所 示 。 当 然 ， 
这 不 仅 是 一 个 新 的 布局 界面 ， 也 是 一 个 新 的 QuizActivity。 
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GeoQuiz 





Canberra is the capital of Australia 


TRUE FALSE 


NEXT 》 





图 3-13 ”处 于 水 平方 位 的 QuizActivity 
设备 旋转 回 竖 直方 位 ， 可 看 到 默认 的 布局 界面 以 及 另 一 个 新 的 QuizActivity。 


3.3 保存 数据 以 应 对 设备 旋转 


适时 使 用 备 选 资源 ，Android 的 这 个 点 子 不错 ， 但 是 ， 设 备 旋转 导致 的 activity 销 毁 与 新 建 有 
时 也 令 人 头疼 。 比 如 ， 设 备 旋 转 后 ，GeoQuiz 应 用 将 回 到 第 一 道 题 。 

要 修复 这 个 缺陷 , 旋转 后 新 建 的 QuizActivity 需 要 知道 mnCurrentIndex 变 量 的 原 值 。 显 然 ， 
在 设备 运行 中 发 生 配 置 变更 时 ， 若 设备 旋转 ， 需 想 个 办 法 保存 以 前 的 数据 。 覆 盖 以 下 Activity 
方法 就 是 一 种 解决 方案 : 

protected void onSaveInstanceState(Bundle outState) 

该 方法 通常 在 onStop() 方 法 之 前 由 系统 调用 ， 除 非 用 户 按 后 退 键 。( 记 住 ， 按 后 退 键 就 是 告 
诉 Android，activity 用 完了 。 随 后 ， 该 activity 就 完全 从 内 存 中 被 抹 掉 ， 自 然 ， 也 就 没有 必要 为 重 
建 保存 数据 了 。 ) 

方法 onSaveInstanceState(BundtLe) 的 默认 实现 要 求 所 有 activity 视 图 将 自身 状态 数据 保存 
在 Bundle 对 象 中 。Bundle 是 存储 字符 串 键 与 限定 类 型 值 之 间 映 射 关 系 ( 键 - 值 对 ) 的 一 种 结构 。 

之 前 已 用 过 Bundle， 如 下 列 代码 所 示 ， 它 作为 参数 传人 onCreate (Bundle) 方 法 : 


@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


























































































































} 

覆盖 onCreate(BundtLe) 方 法 时 , 我 们 实际 是 在 调用 activity 超 类 的 onCreate (Bundle) 方 法 ， 
并 传人 收 到 的 bundle。 在 超 类 代码 实现 里 ， 通 过 取出 保存 的 视图 状态 数据 ，activity 的 视图 层级 结 
构 得 以 重建 。 
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履 盖 onSaveInstanceState(BundtLe ) 方 法 




















可 通过 履 盖 onSaveInstanceState(BundltLe) 方 法 ， 将 一 些 数据 保存 在 bundle 中 ， 然 后 在 
onCreate(BundtLe) 方 法 中 取 回 这 些 数据 。 处 理 设备 旋转 问题 时 ,将 采用 这 种 方式 保存 mCurrent - 
Index 变 量 值 。 

首先 ， 打 开 QuizActivity.java 文 件 ， 新 增 一 个 常量 作为 将 要 存储 在 bundle 中 的 键 - 值 对 的 键 ， 
如 代码 清单 3-5 所 示 。 


代码 清单 3-5 ”新 增 键 - 值 对 的 键 ( QuizActivity.java ) 


public class QuizActivity extends AppCompatActivity { 











private static final String TAG = "QuizActivity"; 
private static final String KEY_INDEX = "index"; 


private Button mTrueButton; 


然后 ， 和 履 盖 onSaveInstanceState(Bundle) 方 法 ， 以 刚才 新 增 的 常量 值 作 为 键 ， 将 
mCurrentIndex 变 量 值 保存 到 bundle 中 ， 如 代码 清单 3-6 所 示 。 








代码 清单 3-6 ”和 履 盖 onSaveInstanceState(Bundle) 方 法 (QuizActivityjava ) 
public class QuizActivity extends AppCompatActivity { 
@Override 
protected void onPause() { 


} 


@Override 

public void onSaveInstanceState(Bundle savedInstanceState) { 
super.onSaveInstanceState(savedInstanceState); 
Log.i(TAG, "onSaveInstanceState"); 
savedInstanceState.putInt(KEY_INDEX, mCurrentIndex); 

} 


@Override 
protected void onStop() { 


} 


， 在 onCreate(Bundle) 方 法 中 确认 是 否 成 功 获 取 该 数值 。 如 果 获 取 成 功 ， 就 将 它 赋值 
是 rrentIndex， 如 代码 清单 3-7 所 示 。 


代码 清单 3-7 在 onCreate(BundtLe) 方 法 中 检查 存储 的 bundle 信 息 〈QuizActivityjava ) 


public class QuizActivity extends AppCompatActivity { 


@Override 
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protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
Log.d(TAG, "onCreate(Bundle) called "); 
setContentView(R.layout.activity quiz); 


if (savedInstanceState != nuLL) { 
mCurrentIndex = savedInstanceState.getInt(KEY_INDEX, 0); 
} 


} 

运行 GeoQuiz 应 用 ， 单 击 NEXT 按 钮 。 现 在 ， 无 论 设备 怎么 旋转 ， 新 创建 的 QuizActivity 都 
能 记 住 当前 正在 回答 的 题目 。 

注意 ,在 BundtLe 中 存储 和 恢复 的 数据 类 型 只 能 是 基本 类 型 (Primitive type ) 以 及 可 以 实现 
Serializable 或 Parcelable 接 口 的 对 象 。 在 Bundle 中 保存 定制 类 对 象 不 是 个 好 主意 ， 因 为 你 
取 回 的 对 象 可 能 已 经 没 用 了 。 比 较 好 的 做 法 是 ， 通 过 其 他 方式 保存 定制 类 对 象 ， 而 在 Bundle 中 
保存 标识 对 象 的 基本 类 型 数据 。 


3.4 再 探 activity 生命 周期 


盖 onSaveInstanceState(Bundte) 方 法 并 不 仅仅 用 于 处 理 与 设备 旋转 相关 的 问题 。 用 户 

离开 当前 activity 用 户 界面 ， 或 Android 需 要 回收 内 存 时 ，activity 也 会 被 销毁 。( 例如 ， 用 户 按 了 主 
屏幕 键 ， 然 后 播放 视频 或 玩 起 游戏 。) 

基于 用 户 体验 考虑 ，Android 从 不 会 为 了 回收 内 存 ， 而 去 销毁 可 见 的 activity ( 处 于 暂停 或 运 
行 状态 )。 只 有 在 调用 过 onStop( ) 并 执行 完成 后 ，activity 才 会 被 标 为 可 销毁 。 

系统 随时 会 销毁 掉 已 停止 的 activity 。 不 用 担心 数据 丢失 ，activity 停 止 时 ， 会 调用 
onSaveInstanceState(Bundte) 方 法 的 。 所 以 ， 解 决 旋转 数据 丢失 问题 ， 就 是 抢 在 系统 销毁 
activity 之 前 保存 数据 。 

保存 在 onSaveInstanceState(BundtLe) 的 数据 该 如 何 幸免 于 难 呢 ? 调用 该 方法 时 ， 用 户 数 
据 随即 被 保存 在 BundtLe 对 象 中 ， 然 后 操作 系统 将 BundtLe 对 象 放 入 activity 记 录 中 。 

为 便于 理解 activity 记 录 , 我 们 增加 一 个 暂 存 状态 (stashed state ) 到 activity 生 命 周 期 , 如 图 3-14 
所 示 。 

activity 暂 存 后 ，Activity 对 象 不 再 存在 ， 但 操作 系统 会 将 activity 记 录 对 象 保存 起 来 。 这 样 ， 
在 需要 恢复 activity 时 ， 操 作 系统 可 以 使 用 暂 存 的 activity 记 录 重 新 激活 activity。 

注意 ，activity 进 入 暂 存 状态 并 不 一 定 需 要 调用 onDestroy() 方 法 。 不 过 ，onStop() 和 
onSaveInstanceState(Bundle) 是 两 个 可 靠 的 方法 ( 除非 设备 出 现 重 大 故障 ),。 因而 , 常见 的 做 
法 是 ， 履 盖 onSaveInstanceState(BundtLe) 方 法 , 在 Bundle 对 象 中 , 保存 当前 activity 的 小 的 或 
暂 存 状态 的 数据 ; 有 覆盖 onStop() 方 法 ,保存 永久 性 数据 ， 如 用 户 编辑 的 文字 等 。onStop() 方 法 
调用 完 ，activity 随 时 会 被 系统 销毁 ， 所 以 用 它 保存 永久 性 数据 。 
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(activity 实 例 已 
销毁 ， 实 例 状态 


















已 保存 ) 启动 完成 或 被 
| 系统 销毁 
onCreate(.…) onDestroy0 


用 户 重启 activity, 
进程 重新 启动 





停止 
(实例 在 内 存 中 ) 


onRestart() 


onStart() onStop() 
| | 
用 户 可 见 用 户 不 可 见 


暂停 
《用 户 可 见 ) 


进入 前 台 离开 前 台 
1 1 
onResume() onPausel() 








图 3-14 ”完整 的 activity 生 命 周期 


那么 暂 存 的 activity 记 录 到 底 可 以 保留 多 久 ? 前 面 说 过 , 用 户 按 了 后 退 键 后 , 系统 会 彻底 销毁 
当前 的 activity。 此 时 ， 暂 存 的 activity 记 录 同 时 被 清除 。 此 外 ， 系 统 重启 的 话 ， 暂 存 的 activity 记 录 
也 会 被 清除 。 


3.5 深入 学 习 : activity 内 存 清理 现状 


撰写 本 书 时 , 低 内 存 状态 下 , Android 直 接 从 内 存 清 除 整 个 应 用 进程 , 连带 应 用 的 所 有 activity。 
目前 ，Android 还 做 不 到 只 销毁 单个 activity。( Android 应 用 都 有 自己 的 进程 。 进程 的 相关 知识 详 见 
24.7 节 。) 

相 比 其 他 进程 ， 有 前 台 (运行 状态 ) 或 可 见 (暂停 状态 ) activity 的 进程 的 优先 级 更 高 。 需 要 
释放 资源 时 ，Android 系 统 的 首选 目标 是 低 优先 级 进程 。 用 户 体验 至 上 ， 理 论 上 ， 操 作 系 统 不 会 
杀 掉 带 有 可 见 activity 的 进程 。 当 然 出 现 重启 或 死机 这 样 的 大 故障 就 难说 了 。( 阁 真 的 出 现 这 种 情 
况 ， 用 户 也 没 空 深究 具体 是 哪个 应 用 被 干掉 了 。) 

覆盖 onSaveInstanceState(Bundle) 方 法 时 ， 应 测试 activity 状 态 是 否 如 预期 般 正 确保 存 和 
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恢复 。 旋 转 设备 好 测 ， 低 内 存 状况 也 好 测 。 亲 自 试 试 吧 。 


在 设备 的 应 用 列表 中 找到 “设置 ”( Settings )。 启 动 Settings， 点 击 Developer options 选 


到 并 启用 Don't keep activities 选 项 ， 如 图 3-15 所 示 。 








现在 运行 应 用 , 单 击 主 


出 现 性 能 问题 。 








屏幕 键 。 如 前 所 述 ， 点 击 主 
就 像 Android 操 作 系 统 回 收 内 存 那样 ， 停 止 的 activity 被 系统 名 
状态 是 否 如 期 得 到 保存 。 测 试 完 毕 ， 记 得 关闭 Don't keep activities 选 项 


BA A 


Developer options 


On 


Profile GPU rendering 
Off 





Apps 


Don't keep activities 人 @ 
Destroy every activity as soon as the user leaves it 


Background process limit 
Standard limit 


Show all ANRs 
Show App Not Responding dialog for background 
apps 


Inactive apps 


Force allow apps on external 
Makes any app eligible to be written to external 
storage, regardless of manifest values 


Force activities to be resizable 
Make all activities resizable for multi-window, 





图 3-15 ”启用 Don’t keep activities 选 项 
































先 项 ， 找 


屏幕 键 会 暂停 并 停止 当前 的 activity。 随 后 
销毁 了 。 重 新 运行 应 用 ， 验 证 activity 
， 耕 则 将 导致 系统 和 应 用 








和 单 击 主屏 幕 键 不 一 样 的 是 ， 单 击 后 退 键 后 ， 无 论 是 否 启用 Don't keep activities 选 项 ， 系 统 





总 是 会 销毁 当前 的 activity。 单 击 后 退 键 相 当 于 告 





3.6 深入 学 习 : 日 志 记录 的 级 别 与 方 ; 


使 用 android.util.Log 类 记录 日 志 ， ee 
重要 程度 的 日 志 级 别 。Android 支 持 如 表 3-2 所 示 的 五 种 日 志 级 别 。 








法 。 要 输出 什么 级 别 的 日 志 ， 








诉 系统 “用 户 不 再 需要 使 用 当前 的 activity”。 








还 可 以 控制 用 来 区 分 信息 
一 个 级 别 对 应 一 个 Log 类 方 





调用 对 应 的 Log 类 方法 就 可 以 了 。 
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表 3-2 日 志 级 别 与 方法 








日 志 级 别 方 ” 法 说 明 
ERROR Log.e(...) 潜 误 
WARNING Log.w(...) 警告 
INFO logit 信息 型 消息 
DEBUG Log.d(...) 调试 输出 (可 能 被 过 滤 掉 ) | 
VERBOSE Log.v(...) 仅 用 于 开发 























需要 说 明 的 是 , 所 有 的 日 志 记 录 方 法 都 有 两 种 参数 签名 : string 类 型 的 tag 参 数 和 msg 参 数 ; 
除 tag 和 msg 参 数 外 再 加 上 Throwabte 实 例 参 数 。 附加 的 ThrowabtLe 实 例 参 数 为 应 用 抛 出 异常 时 记 
录 异 常 信息 提供 了 方便 。 代 码 清单 3-8 展 示 了 两 种 方法 不 同 参数 签名 的 使 用 实例 。 对 于 输出 的 日 
志 信 息 ， 可 使 用 常用 的 Java 字 符 串 连接 操作 拼接 出 需要 的 信息 ， 或 者 使 用 String .format 对 输出 
日 志 信息 进行 格式 化 操作 ， 以 满足 个 性 化 的 使 用 要 求 。 


代码 清单 3-8 ” Android 的 各 种 日 志 记 录 方 式 


// Log a message at "debug" log level 
Log.d(TAG, "Current question index: " + mCurrentIndex); 
































Question question; 

try { 
question = mQuestionBank[mCurrentIndex]; 

} catch (ArrayIndexOut0fBoundsException ex) { 
// Log a message at "error" log level, along with an exception stack trace 
Log.e(TAG, "Index was out of bounds", ex); 


3.7 ”挑战 练习 : 禁止 一 题 多 符 
用 户 答 完 某 道 题 ， 就 禁 掉 那 道 题 对 应 的 按钮 ， 防 止 用户 一 题 多 答 。 
3.8 ”挑战 练习 : 评分 


用 户 答 完 全 部 题 后 ， 显 示 一 个 toast 消 息 ， 给 出 百分比 形式 的 评分 。 

















Android 应 用 的 调试 




















本 章 将 讲解 如 何 处 理应 用 的 bug， 同 时 也 会 介绍 如 何 使 用 LogCat、Android Lint 以 及 Android 
Studio 内 置 的 代码 调试 器 。 
为 练习 调试 ， 我们 先 搞 点 破坏 。 打 开 QuizActivity.java 文 件 ， 在 onCreate (Bundle) 方 法 中 ， 
注释 掉 mQuestionTextView 变 量 赋值 的 那 行 代码 ， 如 代码 清单 4-1 所 示 。 








代码 清单 4-1 注释 掉 一 行 关 键 代码 ( QuizActivity.java ) 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate(Bundle) called"); 
setContentView(R.layout.activity quiz); 


if (savedinstanceState != null) { 
mCurrentindex = savedinstanceState.getint(KEY iNDEX, 0); 


} 
// mQuestionTextView = (TextView)findViewById(R.id.question text view); 


mTrueButton = (Button)findViewById(R.id.true button); 
mTrueButton.setOnClickListener(new View.OnClickListener() { 


}); 
} 
运行 GeoQuiz 应 用 ， 看 看 会 发 生 什么 。 图 4-1 是 应 用 崩溃 后 的 消息 提示 画面 。 不 同 Android 版 


本 的 消息 提示 略 有 差异 ， 但 本 质 上 都 是 一 个 意思 。 
显然 ,我们 知道 应 用 为 何 骨 泪 。 假 如 不 知道 的 话 ， 接 下 来 的 全 新 视角 或 许 能 帮助 解决 问题 。 
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GeoQuiz has stopped 


CGC openappagain 


全 Mute until device restarts 














图 4-1 GeoQuiz 应 用 谣 溃 了 








4.1 异常 与 栈 跟 踪 


为 了 方便 查看 ， 展 开 Android Monitor 工 具 窗 口 。 上 下 滑动 LogCat 窗 口 滚 动 条 ， 应 该 会 看 到 整 
片 红色 的 异常 或 错误 信息 ， 如 图 4-2 所 示 。 这 就 是 标准 的 AndroidRuntime 异 常 信息 报告 。 

如 果 看 不 到 ， 可 试 着 选择 LogCat 的 No Filters 过 滤 项 。 另 外 ， 如 果 党 得 信息 太 多 ， 看 不 过 来 ， 
还 可 以 调整 Log Level 为 Error, 让 系统 只 输出 严重 问题 日 志 。 还 可 以 使 用 搜索 功能 , 比如 搜 “FATAL 
EXCEPTION”， 就 能 直接 定位 到 月 演 异 常 。 

该 异常 报告 首先 给 出 最 高 层级 的 异常 及 其 栈 跟踪 , 然后 是 导致 该 异常 的 异常 及 其 栈 跟踪 。 如 
此 不 断 追 溯 ， 直 到 找到 一 个 没有 原因 的 异常 。 

在 我 们 编写 的 大 部 分 代码 中 , 最 后 一 个 没 给 出 原因 的 异常 往往 就 是 关注 点 。 这 里 , 没有 原因 
的 异常 是 java.Lang.NuLLPointerException。 紧 接着 该 异常 语句 的 一 行 就 是 其 栈 跟 踪 信 息 的 
第 一 行 。 从 该 行 可 以 看 出 发 生 异 常 的 类 和 方法 以 及 它 所 在 的 源 文件 及 代码 行 号 。 单 击 蓝 色 链接 ， 
Android Studio 会 自动 跳 转 到 源 代码 的 对 应 代码 行 。 

Android Studio 定 位 的 这 行 代 码 是 mQuestionTextView 变 量 在 updateQuestion() 方 法 中 的 
首次 使 用 。 名 为 NuLLPointerException 的 异常 暗示 了 问题 所 在 ， 即 变量 没有 初始 化 。 
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89-03 12:44:088. 
Process: com.bignerdranch.android.geoquiz, PID: 5458 
java. lang.RuntimeException: Unable to start activity ComponentInfo{com.bignerdranch.android. ge| 


Caused by: 


523 5458-5458/? E/AndroidRuntime: FATAL EXCEPTION: main 


android.app.ActivityThread.performLaunchActivity(ActivityThread. java:2184) 
android.app.ActivityThread.handleLaunchActivity(ActivityThread. java:2233) 
android.app.ActivityThread.access$800(ActivityThread. java:135) 
android.app.ActivityThreads$H.handleMessage(ActivityThread. java:1196) 
android.os.Handler.dispatchMessage(Handier. java:192) 
android.os.Looper. Loop(Looper. iava:136) 
android.app.ActivityThread.main(ActivityThread.java:5001) 

java. lang. reflect.Method. invokeNative(Native Method) <1 internal caLLs> 
com.android,. internal.os.ZygoteInit$MethodAndArgsCaller. run(ZygoteInit. java:785) 
com.android. internal.os.ZygoteInit.main(ZygoteInit. java:601) 
dalvik. system.NativeStart.main(Native Method) 

java. lang.NullPointerException 
com.bignerdranch.android.geoquiz.QuizActivity.updateQuestion(QuizActivity. java:35) 
com.bignerdranch.android.geoquiz.QuizActivity.onCreate(QuizActivity. java:90) 
android.app.Activity.performCreate(Activity. java:5231) 
android.app. Instrumentation.callActivityOnCreate(Instrumentation. java:I687) 
android,.app.ActivityThread. performLaunchActivity(ActivityThread, java:2148) 
android.app.ActivityThread,.handleLaunchActivity(ActivityThread. java:2233) 
android.app.ActivityThread.access$800(ActivityThread. java:135) 
android.app.ActivityThreads$H.handleMessage(ActivityThread. java:1196) 
android.os.Handler.dispatchMessage(Handler. java:192) 
android.os.Looper. Loop(Looper. java:136) 
android,.app.ActivityThread.main(ActivityThread,. java:5001) 

java. lang. reflect.Method. invokeNative(Native Method) 

java. lang. reflect.Method,. invoke(Method. java:515) <3 more...> 














图 4-2 LogCat 中 的 异常 与 栈 跟 踪 


为 修正 该 问题 ， 取 消 对 变量 maQuestionTextView 赋 值 语句 的 注释 。 





这 里 是 问题 发 生 的 地 方 ， 


如 果 发 生 应 用 月 淡 的 设备 没有 与 计算 机 连接 , 日志 信息 也 不 会 全 部 丢失 。 设备 会 将 最 近 的 日 
志保 存 到 日 志文 件 中 。 日 志文 件 的 内 容 长 度 及 保留 的 时 间 取 决 于 具体 的 设备 , 不 过 ,获取 十 分 钟 
之 内 产生 的 日 志 信 息 通 常 是 有 保证 的 。 只 要 将 设备 连 上 计算 机 ， 在 Devices 视 图 里 选择 所 用 设备 ， 





碰 到 运行 异常 时 , 记得 在 LogCat 中 寻找 最 后 一 个 异常 及 其 栈 跟踪 的 第 一 行 (对 应 着 源 代码 )。 








也 是 寻找 解决 方案 的 最 佳 起 点 。 




















LogCat 会 自动 打开 并 显示 日 志文 件 保 存 的 内 容 。 


4.1.1 诊断 应 用 异常 


即使 出 了 问题 ， 应 用 也 不 一 定 会 崩 演 。 某 些 时 候 , 应 用 只 是 出 现 了 运行 异常 。 例 如 ， 每 次 单 




















击 NEXT 按 钮 时 ， 应 用 都 毫 无 反应 。 这 就 是 一 个 非 崩 演 型 的 应 用 运行 异常 。 


在 QuizActivityjava 中 , 修改 mNextButton 监 听 器 代码 , 注释 掉 mCurrentIndex 变 量 递增 的 语 
句 ， 如 代码 清单 4-2 所 示 。 


代码 清单 4-2 注释 掉 一 行 关 键 代码 (QuizActivityjava ) 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


mNextButton = (Button)findViewById(R.id.next button); 
mNextButton.setOnClickListener(new View.OnClickListener() { 


@Override 
public void 


onClick(View v) { 


// mCurrentIndex = (mCurrentIndex + 1) % mQuestionBank.Length ; 
updateQuestion(); 
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} 
}); 

A 

运行 GeoQuiz 应 用 ， 点 击 NEXT 按 钮 。 可 以 看 到 ， 应 用 无 响应 。 

这 个 问题 要 比 上 一 个 环 手 。 它 没有 抛 出 异常 ， 所 以 ,解决 起 来 不 像 前 面 跟踪 追溯 并 消除 异常 
那么 简单 。 有 了 前 面 的 经 验 ， 这 里 可 以 推测 出 导致 该 问题 的 两 个 因素 : 
口 mCurrentIndex 变 量 值 没有 改变 ; 4 
口 updateQuestion() 方 法 没 被 调用 。 
如 果实 在 没有 头绪 ， 则 需要 设法 跟踪 并 找 出 问题 所 在 。 在 接 下 来 的 几 小 节 里 ,我 们 将 学 习 两 
种 跟踪 问题 的 方法 : 
口 记录 栈 跟踪 的 诊断 性 日 志 ; 
口 利用 调试 器 设置 断 点 调试 。 


























4.1.2 ”记录 栈 跟 踪 日 志 
在 QuizActivity 中 ， 为 updateQuestion() 方 法 添加 日 志 输 出 语句 ， 如 代码 清单 4-3 所 示 。 
代码 清单 4-3 方便 实用 的 调试 方式 ( QuizActivity.java ) 


public class QuizActivity extends AppCompatActivity { 
private void updateQuestion() { 
Log.d(TAG, "Updating question text ", new Exception()); 
int question = mQuestionBank[mCurrentIndex] .getTextResId() ， 


mQuestionTextView.setText(question) ， 
} 


如 同 前 面 AndroidRuntime 的 异常 ，Log.d(String，String，Throwable) 方 法 记录 并 输 
出 整个 栈 跟踪 日 志 。 这 样 ， 就 可 以 很 容易 看 出 updateQuestion() 方 法 在 哪些 地 方 被 调用 了 。 

作为 参数 传人 Log.d(String，String，Throwable) 方 法 的 异常 不 一 定 就 是 已 捕获 的 抛 出 
异常 。 可 以 创建 一 个 全 新 的 Exception， 把 它 作 为 不 抛 出 的 异常 对 象 传 入 该 方法 。 借 此 ， 我 们 得 
到 异常 发 生 位 置 的 记录 报告 。 

运行 GeoQuiz 应 用 ， 点 击 NEXT 按 钮 ， 然 后 在 LogCat 中 查看 输出 结果 ， 如 图 4-3 所 示 。 


09-04 12:47:37.733 38612-38612/com.bignerdranch.android.geoquiz D/QuizActivity : Updating question text 
java. lang. Exception 
at com.bignerdranch.android.geoquiz.QuizActivity.updateQuestion(QuizActivity,. java:34) 






































at com.bignerdranch.android.geoquiz.QuizActivity.access$100(QuizActivity. java:12) 
at com.bignerdranch.android,.geoquiz.QuizActivity$3.onClick(QuizActivity. java:83) 
at android.view.View.performCtLick(View. java:4438) 

at android.view.View$PerformClick. run(View. java:18422) 

at android.os.Handler.dispatchMessage(Handler. iava:95) 

at android.os.Looper. loop(Looper. java:136) 

at android.app.ActivityThread.main(ActivityThread.java:5001) 

at java. lang.reflect.Method. invokeNative(Native Method) <1 internal caLLs> 

at com.android.internat.0s.ZygoteInitS$MethodAndArgsCatter.run(ZygoteInit,.java:785) 
at com.android. internal.os.ZygoteInit.main(ZygoteInit. java:601) 

at dalvik.system.NativeStart.main(Native Method) 


图 4-3 ”输出 结果 
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栈 跟踪 日 志 的 第 一 行 即 调 用 异常 记录 方法 的 地 方 。 紧 接着 的 两 行 表 明 ，updateQuestion() 
方法 是 在 onClick(... ) 实 现 方法 里 被 调用 的 。 点 击 该 行 链接 跳 转 至 注释 掉 的 问题 索引 递增 代码 
行 。 暂 时 不 要 修正 ， 下 一 节 还 会 使 用 设置 断 点 调试 的 方法 重新 查找 该 问题 。 

记录 栈 跟踪 日 志 虽 然 是 个 强大 的 工具 ,但 也 存在 缺陷 。 比 如 ， 大 量 的 日 志 输 出 很 容易 导致 
LogCat 答 口 信息 混乱 难 读 。 此 外 ,通过 阅读 详细 直 白 的 栈 跟踪 日 志 并 分 析 代 人 码 意图 ， 竞争 对 手 可 
以 轻易 梯 窍 我 们 的 创意 。 

男 一 方面 , 既然 有 可 能 从 栈 跟 踪 日 志 看 出 代码 的 真实 意图 ,在 网 站 http://stackoverflow.com 或 
者 论坛 http://forums.bignerdranch.com 上 求助 时 ， 附 上 一 段 栈 跟踪 日 志 往 往 有 助 于 解决 问题 。 如 果 
需要 这 样 做 ， 你 可 以 直接 从 LogCat 中 复制 并 粘贴 日 志 内 容 。 

继续 学 习 之 前 ， 先 删除 日 志 记 录 代 码 ， 如 代码 清单 4-4 所 示 。 


代码 清单 4-4 再 见 ， 老 朋友 ( QuizActivity.java ) 


public class QuizActivity extends AppCompatActivity { 

































































private void updateQuestion() { 


int question = mQuestionBank[mCurrentIndex] .getTextResId!(); 
mQuestionTextView.setText (question); 


} 


4.1.3 ”设置 断 点 


要 使 用 Android Studio 自 带 调试 器 调试 上 一 节 中 的 问题 ,首先 要 在 updateQuestion() 方 法 中 
设置 断 点 ， 以 确认 该 方法 是 否 被 调用 。 断 点 会 在 断 点 设置 行 的 前 一 行 处 停止 代码 执行 ,然后 我 们 
可 以 逐 行 检查 代码 ， 看 看 接 下 来 到 底 发 生 了 什么 。 

在 QuizActivityjava 文 件 中 ， 找 到 updateQuestion() 方 法 , 点击 第 一 行 代码 左边 的 灰色 栏 区 
域 。 可 以 看 到 ， 灰 色 栏 上 出 现 了 一 个 红色 圆 点 。 这 就 是 已 设置 的 一 处 断 点 ， 如 图 4-4 所 示 。 

日 private void updateQuestion() { 
wy int question = mQuestionStore[mCurrentIndex] .getTextResId(); 


mQuestionTextView. setText (question); 
口 } } 























图 4-4 已 设置 的 一 处 断 点 


为 启用 代码 调试 器 并 触发 已 设置 的 断 点 , 我 们 需要 调试 运行 而 不 是 直接 运行 应 用 。 要 调试 运 
行 应 用 ， 单 击 Run 按 钮 旁边 的 Debug 按 钮 ， 或 选择 Run 一 Debug 'app' 菜单 项 。 设 备 会 报告 说 正在 
等 待 调 试 器 加 载 ， 然 后 继续 运行 。 

应 用 启动 并 加 载 调试 器 运行 后 , 就 会 暂停 。 应 用 首先 调用 QuizActivity.onCreate (Bundle) 
方法 ， 该 方法 又 调用 updateQuestion() 方 法 ， 然 后 触发 断 点 。 

如 图 4-5 所 示 ，QuizActivityjava 代 码 已 经 在 代码 编辑 区 打开 了 ， 断 点 设置 所 在 行 的 代码 也 被 
加 亮 显 示 了 。 应 用 在 断 点 处 停止 运行 。 
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®ee £ QuizActivityjava - GeoQuiz - [/Users/dev/AndroidStudioProjects/GeoQuiz] - Android Studio 2.2 Preview 4 
口 生 你 小 交 国 国信 中 人 Ear 区 心 人 入 国 凡 7? Q 
Es GeoQuiz ) Caapp ) DI sre ) 让 main ) Djava ) I com ) 加 bignerdranch ) 四 android ) 四 geoquiz ) (€) QuizActvity 
EE roectries + 图 幸 | 亲 - 且 ， 回 QuizActiviyjava x @ 
图 Gapp 26 new Question("The source of the Nile River is in Egypt.”, false), 9 
图 > Dmanifests 27 new Ouestion("The Amazon River is the Longest river in the Anericas.", true), 生 
加 Y Djava 28 new Question("Lake Baikal is the wortd's oldest and deepest freshwate,..", true) 
| 29 了 
4 Y com.bignerdranch.android.geoquiz 30 
s © b Question 31 private int mCurrentIndex = 0; mcurrentIndex; © 上 
5 i 32 
站 EH QuizActivity . i 
5 4 33 private void updateQuestion() { 
| > Wcom bignenirch mdroki geomde androidTed 34 @ | int question = muestionBank [mCurrentIndex] ,oetTextResId(); . 
了 上 com.bignerdranch.android.geoquiz (test) 35 mQuestionTextView. setText (question); 
Cares 36 } 
风 I 37 
- © Onde scp 38 private void checkAnswer(boolean userPressedTrue) { 
EE 39 boolean answerIsTrue = mQuestionBank[mCurrentIndex] .isAnswerTrue(); 
[3 40 
外 41 int messageResTd = 0 
42 
43 if (userPressedTrue 一 answerIsTruc) { 
44 messageResId = "Correct!"; 
45 } else { 
46 messageResId = "Incorrect!"; 
47 * 
48 
49 Toast.makeText (this, messageResId, Toast.LENGTH_SHORT) 
Debug [3 app 如 各 
孙 vebugger 国 consoe “三 主音 卫 瑟 泗 当 加 惠 中 
1 JE + Variables ~” 
国 ; "main"@4,349 in group "main”: RUNNING + #4 T* this= {QuizActivity@4489)} 


8 TT vvanog adldauppanvywidaethpeco Van 
@ onCreate:86, QuizActivity (com.bignerdranch.android.geoquiz) ly ep 
performCreate:6664. Activity (android.app) 
callActivityOnCreate:1118, Instrumentation (android.app) 
performLaunchActivity:2599, ActivityThread (android.app) 
handleLaunchActivity:2707, ActivityThread (android.app) 
-wrap12:-1, ActivityThread (android.app) 
handleMessage:1460, ActivityThreadSH (android.app) 
dispatchMessage:102, Handler (android.0s) 
loop:154, Looper (android.0s) 
main:60: tivityThread (android.app) 

BR ero $6AndroidMonitor 国 Terminal 园 0:Messages 二: Fventlog 国 Gradle Console 
国 Gradle build finished in 2s 213ms (a minute ago) 34:1 LFs UTF-8 Context:<nocontext> “了 且 


图 4-5 ”代码 在 断 点 处 停止 执行 
这 时 ， 由 Frames 和 Variables 视 图 组 成 的 Debug 工 具 窗 口 出 现在 屏幕 底部 ， 如 图 4-6 所 示 。 


上 & mQuestionBank[mCurrentindex] = {Question@4496} 
国 mCurrentindex = 0 





Bo Build variants 


XH%: 交 上 昌 


苦 2: Favorites 
epon plcypuy 各 






A 
人 
如 





单 步 ” 单 步 。 单 步 
继续 运行 执行 跳 过 执行 ”执行 跳 H 


Ya 


Debugger 国 console 癌 屠 吾 刘 衬 贡 和 油灯 :图 








上 上 





ll 局 Frames -+ 加 variables 


停止 
日 也 "main"@4,348 in group "main": RUNNING 13] 7P? Sthis = {QuizActivity@4488} 
EH updateQuestion:34, QuizActivity (com.bignerdranch.android.geoqu a ol 
图 onCreate:86, QuizActivity (com.bignerdranch.android.geoquiz) SR 
如 





> 6 mQuestionBank[mCurrentindex] 
performCreate:6664, Activity (android.app) 国 mCutrentindex= 0 
callActivityOnCreate:1118, Instrumentation (android.app) 
mg | performLaunchActivity:2599, ActivityThread (android.app) 
handleLaunchActivity:2707, ActivityThread (android.app) 
-wrap12:-1, ActivityThread (android.app) 
避 | handleMessage:1460, ActivityThread$H (android.app) 
关闭 一 x dispatchMessage:102, Handler (android.os) 
loop:154, Looper (android.os) 
2 main:6077, ActivityThread (android.app) 


图 4-6 ”代码 调试 视图 


使 用 视图 顶部 的 箭头 按钮 可 单 步 执行 应 用 代码 。 从 栈 列 表 可 以 看 出 ， ee 
法 已 经 在 onCreate (Bundle) 方 法 中 被 调用 了 。 不 过 , 我 们 关心 的 是 NEXT 按 钮 被 点 击 后 的 行 
因此 ， 单 击 “ 继 续 运行 ”按钮 。 然 后 ， 再 次 点 击 GeoQuiz 中 的 NEXT 按 钮 ， 观 
ee 站 
既然 程序 执行 停 在 了 断 点 处 ， 就 可 以 趁机 看 看 其 他 视图 。 交 量 视图 (Variables ) 可 以 让 我 们 
观察 到 程序 中 各 对 象 的 值 。 应 该 可 以 看 到 在 QuizActivity 中 创建 的 变量 ， 以 及 一 个 特别 的 this 
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变量 值 (QuizActivity 本 身 )。 

展开 this 变 量 后 可 看 到 很 多 变量 。 它 们 是 QuizActivity 类 的 Activity 超 类 、Activity 超 类 
的 超 类 ( 一直 追 溯 到 继承 树 顶 端 ) 的 全 部 变量 。 

我 们 只 需 关 心 mCurrentIndex 变 量 值 。. 在 变量 视图 里 滚动 查看 并 找到 mCurrentIndex。 显 然 ， 
它 现在 的 值 为 0。 

代码 看 上 去 没 问 题 。 为 继续 追查 ， 需 跳出 当前 方法 。 单 击 “ 单 步 执行 跳出 ”按钮 。 
查看 代码 编辑 视图 ， 我 们 现在 跳 到 了 mNextButton 的 0nClickListener 方 法 ， 正 好 是 在 
updateQuestion() 方 法 被 调用 之 后 。 真 是 相当 方便 的 调试 ， 问 题解 决 了 。 
接 下 来 就 是 代码 修正 。 不 过 ， 要 修改 代码 ， 必 须 先 停止 调试 应 用 。 停 止 调 试 有 以 下 两 种 
方式 : 
口 停止 程序 ， 单 击 图 4-6 所 示 的 “停止 ”按钮 ; 
D 呆 开 调试 器 ， 单 击 图 4-6 所 示 的 “关闭 ”按钮 。 

回 到 代码 编辑 区 ， 在 0nCLickListener 方 法 中 ， 取 消 对 mCurrentIndex 语 句 的 注释 ， 如 代 
码 清单 4-5 所 示 。 
代码 清单 4-5 ”取消 代码 注释 ( QuizActivity.java ) 

@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
























































mNextButton = (Button)findViewById(R.id.next button); 
mNextButton.setOnClickListener(new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
A mCurrentIndex = (mCurrentIndex + 1) % mQuestionBank.Length ; 
updateQuestion(); 
} 
}); 
3 
至 此 ， 我 们 尝试 了 两 种 不 同 的 代码 跟踪 调试 方法 : 


口 记录 栈 跟踪 的 诊断 性 日 志 ; 
口 利用 调试 需 设 置 断 点 调试 。 

哪 种 方式 更 好 ? 没有 肯定 的 答案 ， 它 们 各 有 所 长 。 实 际 体验 之 后 ， 或 许 各 有 所 爱 吧 。 

栈 跟 踪 记 录 的 优点 是 , 在 同一 日 志 记 录 中 可 以 看 到 多 处 栈 跟踪 信息 ; 缺点 是 , 必须 学 习 如 何 添 
加 日 志 记 录 方 法 , 重新 编译 、 运 行 应 用 并 跟踪 排查 应 用 问题 。 相对 而 言 , 代码 调试 的 方法 更 为 方便 。 
应 用 以 调试 模式 运行 后 ， 可 在 应 用 运行 的 同时 ， 在 不 同 的 地 方 设置 断 点 ， 寻 找 解 决 问题 的 线索 。 





























4.1.4 使 用 异常 断 点 
前 面 介绍 的 调试 方法 还 不 够 用 ? 那 就 试 试 使 用 调试 器 来 捕捉 异常 吧 。 在 QuizActivityjava 中 ， 
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注释 掉 一 行 代码 ， 让 应 用 骨 溃 ， 如 代码 清单 4-6 所 示 。 


代码 清单 4-6 ”使 GeoQuiz 再 次 崩 演 ( QuizActivity.java ) 
@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


// mNextButton = (Button) findViewById(R.id.next button); 
mNextButton.setOnClickListener(new View.0nCLickListener() { 
@Override 


public void onClick(View v) { 


mCurrentIndex = (mCurrentIndex + 1) % mQuestionBank.length; 
updateQuestion(); 


}); 


选择 Run 一 View Breakpoints... 菜 单项 调 出 异常 断 点 设置 窗口 ， 如 图 4-7 所 示 。 


四 用 @ Breakpoints 
+ 一 回回 加 
@Java Line Breakpoints 


Line 34 in QuizActivityjava 


Enabled 
Line 34 in QuizActivityjava 
@Java Exception Breakpoints Suspend Al © Thread 
Os Condition 


My excep 
@Exception Breakpoints 

When any is t Nn Log message to console Filters 
Log evaluated expression; nce tteres 


Remove once hit 


Class filters: 
Disabled until selected breakpoint is hit: 
<None> 日 
Pass count: 
After breakpoint was hit 。 Disable again Leave enabled 
3 
33 private void updateQuestion() { 
34@ int question = mQuestionBank [mCurrentIndex] .getTextResId(); 
35 mQuestionTextView, setText (question); 
36 } 
37 
7 | Done | 


图 4-7 设置 异常 断 点 

可 以 看 到 ， 当 前 设置 的 断 点 都 显示 在 左边 窗口 ， 选 中 先前 设置 的 断 点 ， 点 击 删 除 按钮 ( - ) 
删除 。 

可 以 使 用 该 对 话 窗口 设置 新 断 点 。 这 样 ， 无 论 任何 时 候 ， 只 要 应 用 抛 出 异常 就 可 以 触发 该 断 
点 。 如 果 需 要 ,可 限制 断 点 仅 针 对 未 捕获 的 异常 生效 ， 也 可 以 设置 为 对 两 种 类 型 的 异常 (未 捕获 
的 和 已 捕获 的 异常 ) 都 生效 。 

单 击 新 增 断 点 按钮 ( + ) 设 置 一 个 新 断 点 。 选 择 下 拉 列 表 中 的 Java Exception Breakpoints 选 项 。 
接 下 来 选择 要 捕捉 的 异常 类 型 。 输 入 RuntimeException ， 按 提示 选择 RuntimeException 
(java.lang )。RuntimeException 是 NuLLPointerException、CLassCastException 及 其 他 常见 
异常 的 超 类 ， 因 此 该 设置 基本 适用 于 所 有 异常 。 
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点 击 Done 按 钮 完成 设置 。 调 试 GeoQuiz 应 用 。 这 次 ， 调 试 器 很 快 就 定位 到 异常 抛 出 的 代码 行 。 
真是 太 棒 了 。 

异常 断 点 影响 极 大 ， 建 议 及 时 清除 那些 不 需要 的 断 点 。 否 则 ,在 调试 的 时 候 ， 如 果 我 们 不 关 
心 的 一 些 系统 框架 代码 或 者 其 他 地 方 发 生 异 常 ， 就 会 触发 先前 设置 的 断 点 。 继 续 学 习 之 前 ， 删 除 
刚才 设置 的 断 点 。 

取消 对 QuizActivityjava 的 代码 注释 ， 让 GeoQuiz 应 用 恢复 正常 。 


4.2 Android 特有 的 调试 工具 


总 体 来 讲 ，Android 应 用 调试 和 Java 应 用 调试 没什么 两 样 。 然 而 ，Android 也 有 其 特有 的 应 用 
调试 场景 ， 如 应 用 资源 问题 。 显 然 ，Java 编 译 器 并 不 擅长 处 理 此 类 问题 。 


























4.2.1 使 用 Android Lint 





该 是 Android Lint 发 挥 作用 的 时 候 了 。Android Lint 是 Android 应 用 代码 的 静态 分 析 器 (static 
analyzer )。 作 为 一 个 特殊 程序 ， 它 能 在 不 运行 代码 的 情况 下 检查 代码 错误 。 和 赁 着 对 Android 框 架 
的 熟练 掌握 ,Android Lint 能 深入 检查 代码 , 找 出 编译 器 无 法 发 现 的 问题 ,在 大 多 数 情况 下 ,Android 
Lint 检 查 出 的 问题 都 值得 重视 。 

在 第 6 章 ， 我们 会 看 到 Android Lint 对 设备 兼容 问题 的 警告 。 此 外 ，Android Lint 能 够 检查 定义 
在 XML 文件 中 的 对 象 类 型 。 在 QuizActivityjava 中 ， 人 为 制造 一 处 错误 ， 如 代码 清单 4-7 所 示 。 


代码 清单 4-7 不 匹配 的 对 象 类 型 ( QuizActivity.java ) 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate(Bundle) called"); 
setContentView(R.layout.activity quiz); 


























mQuestionTextView = (TextView)findViewById(R.id.question text view); 


mTrueButton = (Button) findViewById(R.id.question text view); 


} 

因为 使 用 了 错误 的 资源 ID ， 所 以 代码 运行 时 ， 会 尝试 把 TextView 转 换 为 Button 类 型 ， 这 会 
导致 类 型 转换 错误 。 显 然 , Java 编 译 器 无 能 为 力 , 而 Android Lint 就 能 捕获 到 该 错误 。 可 以 看 到 Lint 
立即 高 亮 显 示 该 行 代 码 ， 指 出 问题 。 

假如 想 主 动 查看 项 目 中 的 所 有 潜在 问题 ， 可 以 选择 Analyze 一 Inspect Code... 菜 单项 手动 运行 
Lint。 在 被 问 及 检查 项 目的 哪 部 分 时 ， 选 择 Whole project。Android Studio 会 立即 运行 Lint 和 其 他 
一 些 静 态 分 析 器 开始 分 析 代码 。 

检查 完毕 ， 所 有 的 潜在 问题 会 按 类 别 列 出 。 展 开 Android Lint 类 别 ， 可 看 到 具体 的 Lint 信 息 ， 
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如 图 4-8 所 示 。 





Inspection Results for Inspection Profile ‘Project Defautt 
pp 国 同 GeoQuiz (37 items) 


Class structure (2 items) 
Ed Code maturity issues (1 item) 
全 Data flow issues (1 item) 


必 世 本 + 省 业 X 


J2ME issues (1 item 
Probable bugs (1 item) 
Spelling (2 items) 
XML (1 item) 











Android > Lint > Correctness (2 items) 

Android > Lint > Internationalization > Bidirectional Text (1 item) 
了 Android > Lint > Performance ( 
六 Android > Lint > Usability (3 items) 
5 Android > Lint > Usability > Icons (9 items) 


Declaration redundancy (5 items) 


图 4-8 ” Lint 警告 信 | 





息 


继续 展开 还 可 以 看 到 更 加 详细 的 信息 ， 包 括 问题 发 生 的 地 方 。 
Mismatched view type 错 误 是 我 们 人 为 制造 的 。 现 在 ,恢复 代码 如 初 ， 如 代码 清单 4-8 所 示 。 


代码 清单 4-8 修正 类 型 不 匹配 的 代码 错误 ( QuizActivityjava ) 





@Override 





protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate(Bundle) called"); 
setContentView(R.layout.activity quiz); 


mQuestionTextView = (TextView)findViewById(R.id.question text view); 


mTrueButton = (Button) findViewById(R.id.true button); 


} 
最 后 ， 重 新 运行 GeoQuiz 应 用 ,确认 已 恢复 。 


4.2.2 R 类 的 问题 





对 于 引用 还 未 添加 的 资源 ,或 者 删除 仍 被 引用 的 资源 而 导致 的 编译 错误 ,我 们 已 经 很 熟悉 了 。 
通常 ， 在 添加 资源 或 删除 引用 后 重新 保存 文件 ，Android Studio 会 准确 无 误 地 重新 编译 项 目 。 
不 过 ， 资 源 编译 错误 有 时 会 一 直 存 在 或 英名 其 妙 地 出 现 。 如 遇 这 种 情况 ， 请 尝试 如 下 操作 。 








口 重新 检查 资源 文件 中 XML 文件 的 有 效 性 












































如 果 最 近 一 次 编译 时 未 生成 Rjava 文 件 ， 项 目 中 资源 引用 的 地 方 都 会 出 错 。 通 常 ， 这 是 由 
某 个 布局 XML 文件 中 的 拼写 错误 引起 的 。 有 既然 布 局 XML 文件 有 时 无 法 得 到 有 效 校 验 ， 拼 
写 错误 自然 也 就 难以 发 现 了 。 修 正 找 到 的 错误 并 重新 保存 XML 文 件 ，Android Studio 会 生 


成 新 的 R.java 文 件 。 


口 清理 项 目 


























选择 Build 一 Clean Project 菜 单项 。Android Studio 会 重新 编译 整个 项 目 ， 消 除 错 误 。 建 议 





经 常 做 深度 项 目 清 理 。 
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口 使 用 Gradle 同 步 项 目 
如 果 修 改 了 build.gradle 配 置 文件 ,就 需要 同步 更 新 项 目的 编译 设置 .选择 Tools 一 Android 一 
Sync Project with Gradle Files 菜 单项 , Android Studio 会 使 用 正确 的 项 目 设置 重新 编译 项 目 。 
这 会 解决 Gradle 配 置 变更 带 来 的 问题 。 
口 运行 Android Lint 
仔细 查看 Lint 警 告 信息 ， 没 准 就 会 有 新 发 现 。 
如 果 仍 有 资源 相关 问题 或 其 他 问题 , 建议 仔细 阅读 错误 提示 并 检查 布局 文件 。 慌乱 时 往往 找 
不 出 问题 。 不 妨 休 息 冷 静 一 下 ， 再 重新 查看 Android Lint 报 告 的 错误 和 和 警告， 或 许 就 能 找 出 代码 
错误 或 拼写 输入 错误 。 
如 果 上 述 操 作 无 法 解决 问题 ， 或 遇 到 其 他 Android Studio 使 用 问题 ， 还 可 以 访问 网 站 
http://stackoverflow.com 或 本 书 论坛 http://forums.bignerdranch.com 求 助 。 


4.3 ”挑战 练习 : 探索 布局 检查 器 


为 了 调试 布局 文件 , 可 使 用 布局 检查 器 以 交互 的 方式 检查 布局 文件 , 研究 它 是 如 何在 屏幕 上 
泻 染 显示 的 。 要 使 用 布局 检查 器 ， 首 先 在 模拟 器 上 启动 GeoQuiz 应 用 ， 然 后 在 Android Monitor 工 
具 窗 口 点 击 最 左边 的 布局 检查 器 按钮 ， 如 图 4-9 所 示 。 布 局 检查 器 激活 后 ， 点 击 布局 检查 器 视图 
里 的 元 素 ， 就 可 以 查看 布局 属性 了 。 


布局 检查 器 












































































Android Moyitor 
醒 gmulator Nexus_5X_API_23 Android 6.0, API 23 ?| com.bignerdranch.an 
间 inafogcat Monitors + 


09-26 10:18:42.057 18446-18446/? I/art: Not late-enabling -Xxcheck:j 
09-26 10:18:42.094 18446-18446/com.bignerdranch.android.geoquiz W/S 
09-26 19:18:42.096 18446-18446/com.bignerdranch.android,geoquiz I/I 
09-26 10:18:43.829 18446-18446/com.bignerdranch.android,geoquiz W/S 
09-26 10:18:43.879 18446-18446/com,bignerdranch.android,geoquiz D/0 
09-26 10:18:43.918 18446-18446/com.bignerdranch.android,geoquiz D/0 
09-26 10:18:43.918 18446-18446/com.bignerdranch.android,.geoquiz D/0 
09-26 10:18:43.927 18446-18574/com.bignerdranch.android.geoquiz D/C 


屿 在 


): 闪 命 : 呈 纲 和 加 中 罗 


09-26 10:18:43.984 18446-18574/com.bignerdranch.android.geoquiz I/0 
09-26 10:19:00.872 18446-18452/com.bignerdranch.android.geoquiz D/C 
09-26 10:20:23.947 18446-18452/com.bignerdranch.android.geoquiz D/C 


戎 2: Favorites 才 Build Variants 


PB,4:Run 后 TODO “GAndroidMonitor 回 Terminal 周 0:Messages 
Gradle build finished in 8s 565ms (28 minutes ago) 














图 4-9 布局 检查 器 按钮 


4.4 挑战 练习 : 探索 内 存 分 配 跟 踪 
针对 应 用 里 内 存 分 配 的 频率 和 次 数 , 内 存 分 配 跟 踪 器 能 给 出 详细 的 跟踪 报告 。 这 大 大 方便 了 
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应 用 的 性 能 优化 。 在 Android Monitor 工 具 窗口 , 点 击 内 存 分 配 跟踪 融 按 钮 启动 它 , 如 图 4-10 所 示 。 
启动 /停止 内 存 分 配 跟 踪 


Android Monitor 






五 Emulator Nexus SX_API_23 Android 6.0, AP1 23 回 com.bignerdranch.android.geoquiz (18446) 
si logcat | Monitors -+* 


Dl (Memory 趾 昌 世 村 :?7 


17.47 MB 
8.00 MB 
0.00 MB- 
1h 10m 4 1h 10m 45s 1h 10m 50s 1h 10m 55s lh llm 0s lh lmss lh llm 10s 


画 cPU IN 区:? 


100.00% 
80.00% 





O08 





40.00% 





0.00% 
1h 10m 4bs lh lom 45s 1h lom sbs Ih 10m 5s 1h Tim bs Yh Tim!s him ds 


画 Network 中 7 


5.00 KB/s 
4.00 KB/s 


2.00 KB/s 
0.00 KB/s- 





1h lom 40s 1h 10m a5s ah lom Sos 1h lom 55s 1n Timbs 1h Tim Ss Ih 11m 10s 


画 CPU WB? 








对 2: Favorites ”名 Build Variants 


0.00 ms- 


BP.4:run ToDo NOOR 加 Temna Bo:Messages 


Received REAL (23 minutes ago) 


图 4-10 ”启动 内 存 分 配 跟踪 器 


随后 ,你 在 前 台 操 作 应 用 ,后 台 就 开始 记录 内 存 分 配 状况 。 一 旦 找到 你 想 优化 的 点 ,就 可 以 
再 次 点 击 内 存 分 配 跟 踪 器 按钮 停止 。 内 存 分 配 报告 随 之 展现 ， 如 图 4-11 所 示 。 


Sam nn i com.bionerdranch.android.geoquiz_2016.09.26_11.07.alloc x 


辑 








Groupby vethod > [ye 





1 Cound Sze| 

时 <Thread1> 1427 (95.71%) 105424 (98.17%) 
上 ® recreateChildDisplayList0:3593, ViewCroup (android view) 3 (0.20%) 32848 (30.59%) 

了 图 draw0:694, RippleDrawable (android.graphics.drawable) 198 (13.28%) 16416 (15.29%) 

Y ® drawBackgroundAndRipples0:893, RippleDrawable (android.graphics.drawable) 156 (10.46%) 12096 (11.26%) 

上 draw0:159, RippleComponent (android.graphies.drawable) 156 (10.46%) 12096 (11.26%0) 


» @ drawBackyroundAndRipples0:887, RippleDrawable (android.graphics.drawable) 42 (2.82%) 4320 (4.02%) 


Sunburst™ | [Sze™ 

Total allocations: 2 
| Total size: 32.80K 
四 <Thread 1 > 
图 recreateChildDisplaylist0.3593, ViewCroup android view) 
@ updateDisplaylistIfDirty0:15134, View (android.view) 
@ dispatchCetDisplayListO:3573, ViewCroup (android view) 
@ recreateChlldDIsplayList0:3593, VlewGroup (androldvlew) 
@ updateDisplayListIfDirty0:15174, View (android.view) 
@ draw0:16169, View (android view) 
@ drawBackground0:16357, View (android view) 
@ getDrawableRenderNode0:16421, View (androld. vew) 
@ draw0:694, RippleDrawable (android.graphics.drawable) 
@® drawBackgroundAndRipples0:854, RippleDrawable (androi 
@ updateMaskShaderlfNeeded0:770, RippleDrawable (androi 
| @ createBitmap0:775, Bitmap (android.graphics) 
@ createBitmap0:808, Bitmap (android.graphics) 
@® createBitmap0:831, Bitmap (android.graphics) 














图 4-11 内 存 分 配 报告 


内 存 分 配 报告 会 列 出 内 存 分 配 发 生 的 次 数 以 及 字 节 大 小 。 在 工具 顶端 选 择 你 需要 的 报表 类 
型 ， 报 表 展 现形 式 可 以 是 表 ， 也 可 以 是 图 。 





Lava 


第 二 个 activity 














本 章 ， 我 们 为 GeoQuiz 应 用 添加 第 二 个 activity。 一 个 activity 控 制 一 屏 信息 ， 新 activity 将 带 来 
第 二 个 用 户 界面 ， 方 便 用 户 偷 看 当前 问题 的 答案 ， 如 图 5-1 所 示 。 


如 


图 5-1 








A 7:00 
GeoQuiz 


Are you sure you want to do this? 


SHOW ANSWER 








CheatActivity 提 供 了 偷 看 答案 的 机 会 





图 5-2 


果 用 户 选择 先 看 答案 ， 然 后 返回 QuizActivity 答 题 ， 则 会 收 到 一 条 信息 ， 如 图 $-2 所 示 。 


A 7:00 
GeoQuiz 


Canberra is the capital of Australia 


TRUE FALSE 
CHEAT! 


NEXT 》 


Cheating is wrong. 


有 没有 偷 看 答案 ，QuizActivity 都 知道 











完成 GeoQuiz 应 用 的 升级 ， 我 们 可 以 学 到 以 下 知识 点 。 


口 








创建 新 的 activity 及 配套 布局 。 


activity 实 例 并 调用 其 onCreate (Bundle) 方 法 。 

















口 从 一 个 activity 中 启动 另 一 个 activity。 所 谓 启 动 activity， 就 是 请 求 Android 系 统 创建 新 的 


口 在 父 activity ( 启动 方 ) 与 子 activity ( 被 启动 方 ) 间 传 递 数据 。 
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5.1 创建 第 二 个 activity 


要 创建 新 的 activity， 有 好 多 繁杂 工作 要 做 。 好 在 Android Studio 有 省事 省 心 的 新 建 activity 
向 导 。 

省 不 省 事 ， 稍 后 便 知 。 现 在 先 打 开 strings.xml 文 件 ， 添 加 本 章 要 用 的 所 有 字符 串 资源 ， 如 代码 
清单 5-1 所 示 。 


代码 清单 5-1 添加 字符 串 资 源 (strings.xml ) 


<resources> 





<string name=" Incorrect toast"> Incorrect!</string> 

<string name="warning_text">Are you sure you want to do this?</string> 
<string name="show_answer_button">Show Answer</string> 

<string name="cheat button">Cheat!</string> 

<string name="judgment_ toast">Cheating is wrong.</string> 


</resources> 


5.1.1 创建 新 的 activity 


创建 新 的 activity 至 少 涉及 三 个 文件 : Java 类 、XML 布 局 和 应 用 的 manifest 文 件 。 这 三 个 文 
件 关联 密切 ， 搞 错 了 就 是 灾难 。 因 此 ， 强 烈 建 议 使 用 Android Studio 的 新 建 activity 向 导 功 能 。 

在 项 目 工 具 窗 口中 ， 右 键 单 击 com.bignerdranch.android.geoquiz 包 ， 选 择 New 一 Activity 一 
Empty Activity 菜 单项 启动 新 建 activity 向 导 ， 如 图 5-3 所 示 。 


















Gs CeoQuiz D3 app main) 让 java) 四 com) EE bignerdranch ) ED android ) EE geoquiz 
Android 0 [* 间 - 有 
» Omanifests 
es y java 
"加 sl- 
s 3 vc 
2 4 ee 锋 Android resource file 
Ee » Ed 记 Android resource directory 
3H 上 巴 4 加 copy %C | 日 File 
» Cires Copy Path 0O%C ED package 
or Gradles Copyas Plain Text 
后 Copy Reference XO%C | 国 C++ Class 
S Paste 3%V | 铝 C/C++ Source File 
时 ~ C/C++ Header File 
Find Usages NF7 
Find in Path... 个 3F 二 Image Asset 
Replace in Path... 个 8R 局 Vector Asset 
Analyze > 
We 国 Singleton 
Refactor 
Edit File Templates... 
Add to Favorites > 
Debvg 状 ap 由 乞 AIDL > 上 
Show Image Thumbnails 全 3T 
各 Debvooe 人 过 Gallery.. 
Reformat Code ^1 和 Android Auto | 一 
上 Er OP oe ee | 十 Always On Wear Activity (Requires minSdk >= 20) 
Delete... 思 | 党 Fragment > 可 Android CU 
8: 沉 Google SS Basic Activity 
2 图 b> Run Tests in com.bignerdranch.and.… 人 ^ 人 OR 党 Other pul Blank Wear Activity (Requires minSdk >= 20) 
3 六 Debug 'Tests in ‘com.bignerdranch.and... ^0D 着 Service > 于 Empty Activity 
如 [5 虱 Run Tests in ‘com.bignerdranch.and..." with Coverage 党 UlComponent | uMsereen Activity 
eo] ee 机 四 ~ Login Activity 
帝王 回 Create Tests in ‘com.bignerdranch.android.geoquiz"... 异 Wear > i 
役 总 widget » | Master/Detail Flow 
站 Local History > 向 XML p> ~ Navigation Drawer Activity 
局 {5 Synchronize 'geoquiz' GB Resource Bundle — Scrolling Activity 


图 5-3 ”新 建 activity 向 导 菜 单 


~ 
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在 随后 弹出 的 对 话 框 中 , Activity Name 处 输入 CheatActivity, 如 图 $-4 所 示 。 这 是 Activity 
子 类 的 名 字 。 可 以 看 到 ，Layout Name 自 动 赋值 为 activity_cheat。 这 是 向 导 为 布局 文件 创建 的 
基本 名 称 。 





@©@ ee New Android Activity 





) Configure Activity 


”Android Studio 


Creates a new empty activity 





Activity Name: CheatActivity 
Generate Layout File 
Layout Name: activity_cheat 


Launcher Activity 


Backwards Compatibility (AppCompat) 


Package name: com.biqnerdranch.android.qeoquiz 四 


Cancel Previous Next Fnmish | 





图 $-4 ”新 的 空 activity 向 导 


由 于 包 名 决定 CheatActivity.java 文 件 存放 的 位 置 ， 再 看 看 包 名 是 否 符合 要 求 。 最 后 ,保持 其 
他 默认 设置 不 变 ， 点 击 Finish 按 钮 见证 向 导 强 大 的 功能 。 

接 下 来 的 任务 是 设计 美观 的 用 户 界面 。 本 章 开 头 的 截图 是 CheatActivity 视 图 完成 后 的 样 
子 。 组 成 视图 的 组 件 定义 如 图 5-5 所 示 。 




















LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android:gravity="center" 
android:orientation="vertical" 
tools:context="com.bignerdranch.android.geoquiz.CheatActivity" 


ey TextView 
TextView Sea m & Button 

y android:id="@+id/answer_text_view" ey . 
android: layout width="wrap_content" _ android:id="@+id/show_answer_button" 

_ android: layout_width="wrap_content" lg 
android: layout_height="wrap_content" z s android: layout_width="wrap_content" 

. android: layout_height="wrap_content" 人 
android:padding="24dp” android: layout_height="wrap_content" 


android:padding="24dp" 
android:text="@string/show_answer_button" 
tools:text="Answer" 


android: text="@string/warning_text" 





图 5-5 组 件 定义 示意 
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Android Studio 应 该 已 经 打开 layout 目 录 中 的 activity_cheat.xml。 如 果 没 有 , 请 打开 它 并 切换 至 
文字 视图 模式 。 
参照 图 $-5 创 建 布局 XML 文件 ， 依 次 以 LinearLayout 组 件 蔡 换 样 例 布局 。 第 9 章 以 后 ， 我 们 
将 不 再 给 出 大 段 的 XML 代码 ， 而 只 会 给 出 类 似 图 $-5 的 布局 组 件 示 意图 。 所 以 ， 最 好 现在 就 习惯 
参照 图 示 创 建 布局 XML 文 件 。 完 成 后 ， 记 得 对 照 代码 清单 -2 核查 。 


代码 清单 5-2 第 二 个 activity 的 布局 组 件 定义 (activity_cheat.xml ) 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout _ width="match_parent" 
android:layout_ height="match_parent" 
android:orientation="vertical" 
android:gravity="center" 
tools:context="com.bignerdranch.android.geoquiz.CheatActivity"> 




















<TextView 
android:layout_ width="wrap_content" 
android:layout_height="wrap_content" 
android:padding="24dp" 
android:text="@string/warning_ text"/> 


<TextView 
android:id="@+id/answer text_ view" 
android:layout width="wrap_content" 
android:layout_height="wrap_content" 
android:padding="24dp" 
tools:text="Answer"/> 


<Button 
android:id="@+id/show_answer_button" 
android:layout width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/show_answer_button"/> 


</LinearLayout> 


注意 用 于 显示 答案 的 TextView 组 件 ， 它 的 tootls 和 tools:text 属 性 的 命名 空间 比较 特别 。 
该 命名 空间 可 以 覆盖 某 个 组 件 的 任何 属性 。 这 样 ， 就 可 以 在 Android Studio 预 览 中 看 到 效果 。 
TextView 有 text 属 性 ， 可 以 为 它 提供 初始 值 ， 因 而 在 应 用 运行 前 就 知道 它 大 概 的 样子 。 而 在 应 
用 运行 时 ，Answer 文 字 不 会 显示 出 来 。 真 的 很 方便 ! 

虽然 没有 创建 供 设备 处 于 水 平方 位 时 使 用 的 布局 文件 , 不 过 , 借助 开发 工具 , 我 们 可 以 预览 
默认 布局 在 水 平方 位 时 的 显示 效果 。 

在 预览 工具 窗口 中 ， 找 到 预览 界面 上 方 工具 栏 里 一 个 画 着 旋转 设备 的 按钮 〈 带 弧 形 蓝 色 箭 
头 )。 单 击 该 按钮 切换 布局 预览 方位 ， 如 图 5-6 所 示 。 














nl 
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Preview 次 用 
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3 





图 5-6 ”水 平方 位 预览 布局 (activity_cheat.xml ) 


可 以 看 到 ， 默 认 布 局 在 竖 直 方位 与 水 平方 位 下 效果 都 不 错 。 布 局 搞定 了 ， 接 着 是 创建 新 的 


activity 子 类 。 














5.1.2 ”创建 新 的 activity 子 类 


在 项 目 工具 窗口 中 , 找到 com.bignerdranch.android.geoquiz 类 包 ，, 打开 CheatActivity.java 文 件 。 

当前 , CheatActivity 类 已 有 onCreate(Bundle) 方 法 的 默认 实现 , 用 来 将 activity_cheat.xml 
文件 中 的 布局 资源 ID 传 递 给 setContentView(...) 方 法 。 

CheatActivity 类 的 onCreate (Bundle) 方 法 还 有 更 多 的 事情 要 做 。 现 在 ， 先 一 起 来 看 看 新 
建 activity 向 导 自 动 完成 的 另 一 件 事 : manifest 配 置 文件 中 的 CheatActivity 声 明 。 








5.1.3 在 manifest 配置 文件 中 声明 activity 


manifest 配 置 文件 是 一 个 包含 元 数据 的 XML 文件 , 用 来 向 Android 操 作 系统 描述 应 用 。 该 文件 
总 是 以 AndroidManifest.xml 命 名 ， 可 在 项 目的 app/manifests 目 录 中 找到 它 。 
在 项 目 工 具 窗 口中 ,找到 并 打开 AndroidManifest.xml。 还 可 使 用 Android Studio 的 快速 打开 文 
件 功能 : 使 用 Command+ShifttO (或 Ctrl+ShiftHN ) 快捷 键 ， 呼 出 快速 打开 对 话 框 ， 利 用 提示 功 
能 或 直接 输入 目标 文件 名 ， 按 回 车 键 打开 。 

应 用 的 所 有 activity 都 必须 在 manifest 配 置 文件 中 声明 ， 这 样 操 作 系 统 才能 够 找到 它们 。 

创建 QuizActivity 时 , 因 使 用 了 新 建 应 用 向 导 , 向 导 已 自动 完成 声明 工作 。 同 样 ,新 建 activity 
向 导 也 自动 声明 了 CheatActivity， 如 代码 清单 5-3 灰 底部 分 所 示 。 


代码 清单 5-3 ”在 manifest 配 置 文件 中 声明 CheatActivity ( AndroidManifest.xml ) 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.bignerdranch.android.geoquiz" > 


















































<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme" > 
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<activity android:name=" .QuizActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


<activity android:name=".CheatActivity"> 
</activity> 
</application> 


</manifest> 

这 里 的 android:name 属 性 是 必需 的 。 属 性 值 前 面 的 .告诉 操作 系统 : activity 类 文件 位 于 
manifest 配 置 文件 头 部 包 属 性 值 指 定 的 包 路 径 下 。 

android:name 属 性 值 也 可 以 设置 成 完整 的 包 路 径 , 如 android:name="com.bignerdranch. 
android.geoquiz.CheatActivity"， 这 与 代码 清单 5-3 里 的 写法 效果 相同 。 

manifest 配 置 文件 里 还 有 很 多 有 趣 的 东西 。 不 过 ， 现 在 还 是 先 集中 精力 搞定 CheatActivity 
的 配置 和 和 运行。 在 后 续 章 节 中 ， 我 们 还 将 学 习 到 更 多 有 关 manifest 配 置 文件 的 知识 。 














如 




















5.1.4 为 QuizActivity 添加 CHEAT 按钮 





按照 开发 设想 ,用 户 在 QuizActivity 用 户 界面 上 点 击 某 个 按钮 ,应 用 立即 创建 CheatActivity 
实例 ， 并 显示 其 用 户 界 面 。 这 就 需要 在 layoutactivity_quiz.xml 和 1layout-land/activity quiz.xml 布 局 
文件 中 定义 新 按钮 。 

在 默认 的 垂直 布局 中 ， 添 加 新 按钮 定义 并 设置 其 为 根 LinearLayout 的 直接 子 类 。 新 按钮 应 
该 定义 在 NEXT 按 钮 之 前 ， 如 代码 清单 5-4 所 示 。 


代码 清单 5-4 ”在 默认 布局 中 添加 CHEAT 按 钮 ( layout/activity_quiz.xml ) 























</LinearLayout> 


<Button 
android:id="@+id/cheat button" 
android:layout width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/cheat_button"/> 


<Button 
android:id="@+id/next button" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:text="@string/next_ button" 
android:drawableRight="@drawable/arrow right" 
android:drawablePadding="4dp"/> 


</LinearLayout> 
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在 水 平 布 局 模式 中 ， 新 按钮 定义 在 根 FrameLayout 的 底部 居中 位 置 ， 如 代码 清单 5-5 所 示 。 
代码 清单 5-5 “在 水 平 布局 中 添加 CHEAT 按 钮 (layoutrland/activity quiz.xml ) 








</LinearLayout> 


<Button 
android:id="@+id/cheat button" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:layout gravity="bottom|center_ horizontal " 
android:text="@string/cheat button" /> 


<Button 
android:id="@+id/next button" 
android:Layout width="wrap content" 
android:layout height="wrap_ content" 
android:layout gravity="bottom|right" 
android:text="@string/next button" 
android:drawableRight="@drawable/arrow right" 
android:drawablePadding="4dp" /> 


</FrameLayout> 
EE 新 打开 QuizActivityjava 文 件 ， 添 加 新 按钮 变量 以 及 资源 引用 代码 。 最 后 为 CHEAT 按 钮 添 
加 View.onCLickListener 监 听 器 代码 存根 ， 如 代码 清单 $-6 所 示 。 


代码 清单 5-6 ”启用 CHEAT 按 钮 (QuizActivityjava ) 
public class QuizActivity extends AppCompatActivity { 











[fadl\ 





private Button mNextButton; 
private Button mCheatButton; 
private TextView mQuestionTextView; 


@Override 
protected void onCreate(Bundle savedinstanceState) { 


mNextButton = (Button) findViewByid(R.id.next button); 
mNextButton.setOnClicklistener(new View.0nCLickListener() { 


@Override 
public void onClick(View v) { 
mCurrentindex = (mCurrentindex + 1) % mQuestionBank.Length ; 


updateQuestion(); 
} 
}); 


mCheatButton = (Button)findViewById(R.id.cheat button); 
mCheatButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// Start CheatActivity 
} 
}); 
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updateQuestion(); 


人 
准备 工作 完成 了 ， 下 面 来 学 习 如 何 启动 CheatActivity。 





5.2 启动 activity 

















一 个 activity 启 动 另 一 个 activity 最 简单 的 方式 是 使 用 startActivity 方 法 : 

public void startActivity(Intent intent) 

你 也 许 会 想当然 地 认为 ，startActivity(Intent ) 方 法 是 一 个 静态 方法 ， 局 动 activity 就 是 Gog 
调用 Activity 子 类 的 该 方法 。 实 际 并 非 如 此 。activity 调 用 startActivity(Intent ) 方 法 时 ， 调 
用 请 求实 际 发 给 了 操作 系统 。 

准确 地 说 ， 调 用 请 求 发 送 给 了 操作 系统 的 ActivityManager。ActivityManager 负 责 创建 
Activity 实 例 并 调用 其 onCreate (Bundle) 方 法 ， 如 图 5-7 所 示 。 






































应 用 | Android 操 作 系 统 


Activity ActivityManager 


startActivity(Intent) 


Y 


= 


图 5-7 ”启动 activity 


ActivityManager 该 启动 哪个 activity 呢 ? 答案 就 在 于 传人 startActivity(Intent) 方 法 的 
Intent 人 参数 。 


基于 intent 的 通信 
intent 对 象 是 component 用 来 与 操作 系统 通信 的 一 种 媒介 工具 。 目 前 为 止 ， 我 们 唯一 见 过 的 


component 就 是 activity。 实 际 上 还 有 其 他 一 些 component: service 、broadcast receiver 以 及 content 
provider。 

intent 是 一 种 多 用 途 通 信 工 具 。Intent 类 有 多 个 构造 方法 ， 能 满足 不 同 的 使 用 需求 。 

在 GeoQuiz 应 用 中 ,intent 用 来 告诉 ActivityManager 该 启动 哪个 activity, 因此 可 使 用 以 下 构 
造 方法 : 


























AS - 立 - 
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public Intent(Context packageContext, Class<?> cls) 
传人 该 方法 的 Class 类 型 参数 告诉 ActivityManager 应 该 启动 哪个 activity; Context 参 数 告 
诉 ActivityManager 在 哪里 可 以 找到 它 ， 如 图 $-8 所 示 。 





GeoQuiz Android 操 作 系 统 


QuizActivity ActivityManager 


上 一 startActivity 1 
(nten) 一 [mw | 
component=CheatActivity 











(Intent) A 
ereanomy | 4- 
| 
YY 


y 
| 





图 $-8 intent: ActivityManager 的 信使 


在 mCheatButton 的 监听 器 代码 中 ,创建 包含 cheatActivity 类 的 Intent 实 例 ， 然 后 将 其 传 
入 startActivity(Intent) 方 法 ， 如 代码 清单 5-7 所 示 。 





代码 清单 5-7 启动 CheatActivity ( QuizActivity.java ) 


mCheatButton = (Button)findViewById(R.id.cheat button); 
mCheatButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// Start CheatActivity 
Intent intent = new Intent(QuizActivity.this, CheatActivity.class); 
startActivity(intent); 
} 
}); 


在 启动 activity 前 ，ActivityManager 会 确认 指定 的 CLass 是 否 已 在 manifest 配 置 文件 中 声明 。 
如 果 已 完成 声明 ， 则 启动 activity， 应 用 正常 运行 。 反 之 ， 则 抛 出 ActivityNotFoundException 
异常 ， 应 用 骨 溃 。 这 就 是 必须 在 manifest 配 置 文件 中 声明 应 用 的 全 部 activity 的 原因 。 

运行 GeoQuiz 应 用 。 单 击 CHEAT! 按 钮 ， 新 activity 实 例 的 用 户 界面 将 显示 在 屏幕 上 。 点 击 后 退 
按钮 ，CheatActivity 实 例会 被 销毁 ，QuizActivity 实 例 的 用 户 界面 又 出 现 了 。 

显 式 intent 与 隐 式 intent 

如 果 通 过 指定 Context 与 Class 对 象 , 然后 调用 intent 的 构造 方法 来 创建 Intent, 则 创建 的 是 
显 式 intent。 在 同一 应 用 中 ， 我 们 使 用 显 式 intent 来 启动 activity。 

同一 应 用 里 的 两 个 activity， 却 要 借助 于 应 用 外 部 的 ActivityManager 通 信 ， 这 似乎 有 点 怪 。 
不 过 ， 这 种 模式 会 让 不 同 应 用 间 的 activity 交 互 变 得 容易 很 多 。 

一 个 应 用 的 activity 如 需 启 动 另 一 个 应 用 的 activity， 可 通过 创建 隐 式 intent 来 处 理 。 我 们 会 在 
第 15 章 学 习 使 用 隐 式 intent。 
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5.3 activity 间 的 数据 传递 


QuizActivity 和 CheatActivity 都 已 就 绕 ， 现 在 可 以 考虑 它们 之 间 的 数据 传递 了 。 图 5-9 展 
示 了 两 个 activity 间 传递 的 数据 信息 。 


答案 是 否 正确 





QuizActivity 





CheatActivity 


和 用 户 是 否 作 昨 


图 5-9”QuizActivity 与 CheatActivity 的 对 话 
CheatActivity 启 动 后 ，QuizActivity 会 通知 它 当 前 问题 的 答案 。 
用 户 知 道 答 案 后 ， 点 击 后 退 键 回 到 QuizActivity，CheatActivity 随 即 被 销毁 。 在 销毁 前 
的 瞬间 ， 它 会 将 用 户 是 否 作 次 的 数据 传递 给 QuizActivity。 
接 下 来 ， 首 先 处 理 从 QuizActivity 到 CheatActivity 的 数据 传递 。 


5.3.1 使 用 intent extra 
为 通知 CheatActivity 当 前 问题 的 答案 ， 需 将 以 下 语句 的 返回 值 传递 给 


mQuestionBank[mCurrentIndex].isAnswerTrue() 


该 值 将 作为 extra 信 息 ， 附 加 在 传人 startActivity(Intent) 方 法 的 Intent 上 发 送出 去 。 

extra 信 息 可 以 是 任意 数据 ， 它 包含 在 Intent 中 ， 由 启动 方 activity 发 送出 去 。 可 以 把 extra 信 
息 想 象 成 构造 函数 参数 ， 虽 然 我 们 无 法 使 用 带 activity 子 类 的 构造 函数 。( Android 创 建 activity 实 
例 ， 并 负责 管理 其 生命 周期 。) 接受 方 activity 接 收 到 操作 系统 转发 的 intent 后 ,访问 并 获取 其 中 的 
extra 数 据 信息 ， 如 图 5-10 所 示 。 





















































GeoQuiz | Android 操 作 系 统 


QuizActivity ActivityManager 


1 1 
mm—— startActivity (Intent) 


component=CheatActivity 
extra=EXTRA_ANSWER_IS_TRUE 





| (Intent) 
| | 
图 5-10 ”intent extra: activity 间 的 通信 与 数据 传递 
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如 同 QuizActivity.onSaveInstanceState(Bundle) 方 法 中 用 来 保存 mCurrentIndex 值 
的 键 值 结构 ，extra 也 是 一 种 键 值 结构 。 





























要 将 extra 数 据 信息 添 加 给 intent, 需要 调用 Intent.putExtra(...) 方 法 。 确切 地 说 , 是 调用 
如 下 方法 : 

public Intent putExtra(String name, boolean value) 

Intent.putExtra(...) 方 法 形式 多 变 。 不 变 的 是 ， 它 总 是 有 两 个 参数 。 一 个 参数 是 固定 为 
































String 类 型 的 键 ， 另 一 个 参 数 是 键 值 ， 可 以 是 多 种 数据 类 型 。 该 方法 返回 intent 自 身 ， 因 此 ， 需 
要 时 可 进行 链 式 调用 。 
在 CheatActivity.java 中 ， 为 extra 数 据 信 息 新 增 键 - 值 对 中 的 键 ， 如 代码 清单 5-8 所 示 。 


代码 清单 5-8 添加 extra 常 量 ( CheatActivity.java ) 
] 
public class CheatActivity extends AppCompatActivity { 











private static final String EXTRA ANSWER_ IS TRUE = 
"com.bignerdranch.android.geoquiz.answer is true"; 


activity 可 能 启动 自 不 同 的 地 方 ， 所 以 ,应 该 在 获取 和 使 用 extra 信 息 的 activity 那 里 ,为 它 定义 
键 。 如 代码 清单 5-8 所 示 ， 记 得 使 用 包 名 修饰 extra 数 据 信息 ， 这 样 ， 可 避免 来 自 不 同 应 用 的 extra 
间 发 生命 名 冲突 。 

现在 ， 可 以 返回 到 QuizActivity， 将 extra 附 加 到 intent 上 。 不 过 我 们 有 个 更 好 的 实现 方法 。 
对 于 CheatActivity 处 理 extra 信 息 的 实现 细节 ，QuizActivity 和 应 用 的 其 他 代码 无 需 知道 。 
此 ,我 们 可 转 而 在 newIntent(.. . ) 方 法 中 封装 这 些 逻 辑 。 

在 CheatActivity 中 ， 着 NEWENEEhte . ) 方 法 ， 如 代码 清单 5-9 所 示 。 














代码 清单 5-9 ”CheatActivity 中 的 newIntent(...) 方 法 (CheatActivityjava ) 
public class CheatActivity extends AppCompatActivity { 


private static final String EXTRA ANSWER IS TRUE = 
"com.bignerdranch.android.geoquiz.answer is true"; 


public static Intent newIntent(Context packageContext, boolean answerIsTrue) { 
Intent intent = new Intent(packageContext, CheatActivity.class); 
intent.putExtra(EXTRA ANSWER IS TRUE, answerIsTrue); 
return intent; 























使 用 新 建 的 静态 方法 ， 可 以 正确 创建 Intent ， 它 配置 有 CheatActivity 需 要 的 extra。 
answerIsTrue 布 尔 值 以 EXTRA_ANSWER_IS_TRUE 常 量 放 入 intent 以 供 解 析 。 利 用 这 种 方式 ， 配 置 
传递 intent 是 不 是 容易 多 了 ? 

在 QuizActivity 的 按钮 监听 器 中 ， 应 用 newIntent(,.,) 方 法 ， 如 代码 清单 5-10 所 示 。 
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代码 清单 5-10 ”用 extra 启 动 ( QuizActivity.java ) 


mCheatButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// Start CheatActivity 
I . 和 I (QuizActivi pi ct Ri 1 ) 
boolean answerIsTrue = mQuestionBank[mCurrentIndex] .isAnswerTrue(); 
Intent intent = CheatActivity.newIntent(QuizActivity.this, answerIsTrue); 
startActivity(intent); 
} 
}); 
这 里 只 需 一 个 extra， 但 如 果 有 需要， 也 可 以 附加 多 个 extra 到 同一 个 Intent 上 。 如 果 附 加 多 
个 extra， 也 要 给 newIntent(... ) 方 法 相应 添加 多 个 参数 。 


要 从 extra 获 取 数 据 ， 会 用 到 如 下 方法 : 

public boolean getBooleanExtra(String name, boolean defaultValue) 

一 个 参数 是 extra 的 名 字 。getBooleanExtra(.,,) 方 法 的 第 二 个 参数 是 指定 默认 值 ( 默认 
答案 )， 它 在 无 法 获得 有 效 键 值 时 使 用 。 


在 CheatActivity 代 码 中 , 编写 代码 实现 从 extra 获 取信 息 , 存 人 成 员 变 量 中 , 如 代码 清单 5-11 
所 示 。 


代码 清单 5-11 获取 extra 信 息 ( CheatActivity.java ) 
public class CheatActivity extends AppCompatActivity { 








A 
下 






































private static final String EXTRA ANSWER IS TRUE = 
"com.bignerdranch.android.geoquiz.answer is true"; 


private boolean mAnswerIsTrue; 
@Override 
protected void onCreate(Bundle savedIinstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity cheat); 


mAnswerIsTrue = getIntent().getBooleanExtra(EXTRA ANSWER_IS_TRUE, false); 


} 


请 注意 ，Activity.getIntent() 方 法 返回 了 由 startActivity(Intent) 方 法 转发 的 
2 
， 在 CheatActivity 代 码 中 ， 实 现 单 击 SHOW ANSWER 按 钮 后 获取 答案 并 将 其 显示 在 
ER 如 代码 清单 5-12 所 示 。 


代码 清单 5-12 ”提供 作弊 机 会 ( CheatActivity.java ) 
public class CheatActivity extends AppCompatActivity { 








A 
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private boolean mAnswerlsTrue; 


private TextView mAnswerTextView; 

private Button mShowAnswerButton; 

@Override 

protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity cheat); 


mAnswerIsTrue = getIntent().getBooleanExtra(EXTRA ANSWER IS TRUE, false); 
mAnswerTextView = (TextView) findViewById(R.id.answer text view); 


mShowAnswerButton= (Button) findViewById(R.id.show answer_button); 
mShowAnswerButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
if (mAnswerIsTrue) { 
mAnswerTextView.setText(R.string.true_button); 
} else{ 
mAnswerTextView.setText(R.string.false button); 


} 
}); 


} 

以 上 代码 比较 直观 。TextView.setText(int) 方 法 用 来 设置 TextView 要 显示 的 文字 。 
TextView.setText(...) 方 法 有 多 种 变 体 。 这 里 通过 传人 资源 ID 调 用 该 方法 。 

运行 GeoQuiz 应 用 。 单 击 CHEAT! 按 钮 弹出 CheatActivity 的 用 户 界面 ， 然 后 单 击 SHOW 
ANSWER 按 钮 查看 当前 问题 的 答案 。 





























5.3.2 ”从 子 activity 获取 返回 结果 


现在 , 用 户 可 以 训 无 顾忌 地 偷 看 答案 了 。 如 果 CheatActivity 能 把 用 户 是 否 看 过 答案 的 情况 
通知 给 QuizActivity 就 更 好 了 。 下 面 我 们 来 解决 这 个 问题 。 

需要 从 子 activity 获 取 返 回信 息 时 ， 可 调用 以 下 Activity 方 法 : 

public void startActivityForResult(Intent intent, int requestCode) 

该 方法 的 第 一 个 参数 同 前 述 的 intent。 第 二 个 参数 是 请 求 代码 。 请 求 代 码 是 先 发 送 给 子 
activity， 然 后 再 返回 给 父 activity 的 整数 值 ， 由 用 户 定 义 。 在 一 个 activity 启 动 多 个 不 同类 型 的 子 
activity， 且 需要 判断 消息 回馈 方 时 ， 就 会 用 到 该 请 求 代 码 。 虽 然 QuizActivity 只 启动 一 种 类 型 
的 子 activity， 但 为 应 对 未 来 的 需求 变化 ， 现 在 就 应 设置 请 求 代码 常量 。 

在 QuizActivity 中 , 修改 mCheatButton 的 监听 器 , 调用 startActivityForResult(Intent，, 
int) 方 法 ， 如 代码 清单 5-13 所 示 。 
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代码 清单 5-13 ”调用 startActivityForResult(...) 方 法 (QuizActivity.java ) 
public class QuizActivity extends AppCompatActivity { 


private static final String TAG = "QuizActivity"; 
private static final String KEY INDEX = "index"; 
private static final int REQUEST CODE CHEAT = 0; 
@Override 

protected void onCreate(Bundle savedIinstanceState) { 


mCheatButton.setOnClickListener(new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
// Start Cheat Activity 


boolean answerIsTrue = mQuestionBank[mCurrentIndex].isAnswerTrue(); 
Intent intent = CheatActivity.newIntent (QuizActivity.this, answerIsTrue); 





startActivity(intent}); 
startActivityForResult(intent, REQUEST_ CODE_CHEAT); 
} 
}); 


1. 设置 返回 结果 
实现 子 activity 发 送 返 回信 息 给 父 activity， 有 以 下 两 种 方法 可 用 : 


public final void setResult(int resultCode) 
public final void setResult(int resultCode, Intent data) 


一 般 来 说 ， 参 数 resultcode 可 以 是 以 下 任意 一 个 预定 义 常量 。 
OQ Activity .RESULT OK 
DActivity .RESULT CANCELED 

(如 需 自己 定义 结果 代码 ， 还 可 使 用 另 一 个 常量 : RESULT_FIRST_USER。 ) 

在 父 activity 需 要 依据 子 activity 的 完成 结果 采取 不 同 操作 时 ， 设 置 结 果 代 码 就 非常 有 用 。 

例如 ， 假 设 子 activity 有 一 个 OK 按钮 和 一 个 Cancel 按 钮 ， 并 且 每 个 按钮 的 单 击 动作 分 别 设 置 
有 不 同 的 结果 人 代码。 那么 ， 根 据 不 同 的 结果 代码 ， 父 activity 就 能 采取 不 同 的 操作 。 

子 activity 可 以 不 调用 setResutLt ( .. . ) 方 法 。 如 果 不 需 要 区 分 附加 在 intent 上 的 结果 或 其 他 信 
息 ,可 让 操作 系统 发 送 默认 的 结果 代码 。 如 果子 activity 是 以 调用 startActivityForResutt(...) 
方法 启动 的 ， 结 果 代 码 则 总 是 会 返回 给 父 activity。 在 没有 调用 setResult(...) 方 法 的 情况 下 ， 
如 果 用 户 按 了 后 退 按钮 ， 父 activity 则 会 收 到 Activity .RESULT_CANCELED 的 结果 代码 。 

2. 返还 intent 

GeoQuiz 应 用 中 ,数据 信 息 需 要 回 传 给 QuizActivity。 因 此 ,我们 需要 创建 一 个 Intent， 附 
加 上 extra 信 息 后 ， 调 用 Activity.setResult(int，Intent) 方 法 将 信息 回 传 给 QuizActivity。 

在 CheatActivity 代 码 中 ， 为 extra 的 键 增 加 常量 ， 再 创建 一 个 私有 方法 ， 用 来 创建 intent、 
附加 extra 并 设置 结果 值 。 然 后 在 SHOW ANSWER 按 钮 的 监听 器 代码 中 调用 该 方法 。 设 置 结果 值 
的 方法 如 代码 清单 5-14 所 示 。 
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代码 清单 5-14 设置 结果 值 ( CheatActivity.java ) 
public class CheatActivity extends AppCompatActivity { 


private static final String EXTRA ANSWER IS TRUE = 
"com.bignerdranch.android.geoquiz.answer is true"; 
private static final String EXTRA ANSWER SHOWN = 
"com.bignerdranch.android.geoquiz.answer_shown"; 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
mShowAnswerButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
if (mAnswerIsTrue) { 
mAnswerTextView.setText(R.string.true button); 
} else { 
mAnswerTextView.setText(R.string.false button); 


} 


setAnswerShownResult (true); 


}); 
} 


private void setAnswerShownResult(boolean isAnswerShown) { 
Intent data = new Intent(); 
data.putExtra(EXTRA ANSWER SHOWN, isAnswerShown); 
setResult(RESULT_ OK, data); 


} 


用 户 单 击 SHOW ANSWER 按 钮 时 ，CheatActivity 调 用 setResult (int，Intent) 方 法 将 
结果 代码 以 及 intent 打 包 。 
然后 ， 在 用 户 按 后 退 键 回 到 QuizActivity 时 ，ActivityManager 调 用 父 activity 的 以 下 方法 : 


protected void onActivityResult(int requestCode, int resultCode, Intent data) 


该 方法 的 参数 来 自 QuizActivity 的 原始 请 求 代 码 以 及 传人 setResuLt(int，Intent ) 方 法 
的 结果 代码 和 intent。 
图 $-11 展 示 了 应 用 内 部 的 交互 时 序 。 
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GeoQuiz Android 操 作 系 统 
| 


用 户 按 下 CHEAT 按 钮 ， 


onClick(View) 被 调用 | Intent | 
PT startActiv ityForResult component=CheatActivity 
(Intentint) extra=EXTRA_ANSWER_IS_TRUE 


requestCode=0 


(Intent) 
SheatActivity 


! 户 按 下 SHOW ANSWER,， | 




















\ 














setResult (int) 被 调用 











resultCode=RESULT_OK 


六 忽 F 后 退 按钮 [ent | 


术 | extra=EXTRA_ANSWER_SHOWN 


(requestCode, resultCode, Intent) 


onActigResalt ——— 


(int, int, Intent) | 

















上 


i 


图 5-11 ”GeoQuiz 应 用 内 部 的 交互 时 序 图 





但 





最 后 履 盖 QuizActivity 的 onActivityResuLt(int，int，Intent) 方 法 来 处 理 返回 结果 。 
然而 ， 结 果 intent 的 内 容 也 是 CheatActivity 的 实现 细节 ， 因 而 还 要 添加 另 一 个 方法 协助 解析 出 
QuizActivity 能 用 的 信息 ， 如 代码 清单 5-15 所 示 。 


代码 清单 5-15 ”解析 结果 intent ( CheatActivity.java ) 


public static Intent newIntent (Context packageContext, boolean answerIsTrue) { 
Intent intent = new Intent(packageContext, CheatActivity.class); 
intent.putExtra(EXTRA ANSWER IS TRUE, answerIsTrue); 
return intent; 


} 


public static boolean wasAnswerShown(Intent result) { 
return result.getBooleanExtra(EXTRA_ ANSWER_SHOWN, false); 
} 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


} 
3. 处 理 返 回 结果 
在 QuizActivityjava 中 ， 新 增 一 个 成 员 变 量 保存 CheatActivity 回 传 的 值 。 然 后 覆盖 
OA ye . ) 方 法 获取 它 。 别 忘 了 检查 请 求 代码 和 返回 代码 是 否 符 合 预期 ,实践 证 明 ， 
这 样 做 会 方便 将 来 的 代码 维护 。 onActivityResult(...) 方 法 的 实现 如 代码 清单 5-16 所 示 。 
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代码 清单 5-16 ”onActivityResult(...) 方 法 的 实现 (QuizActivityjava ) 
public class QuizActivity extends AppCompatActivity { 
private int mCurrentIndex = 0; 
private boolean mIsCheater; 
@Override 
protected void onCreate(Bundle savedInstanceState) { 


} 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (resultCode != Activity.RESULT OK) { 
return; 


} 


if (requestCode == REQUEST CODE CHEAT) { 
if (data == nuLL) { 
return; 


} 


mIsCheater = CheatActivity .wasAnswerShown (data); 


} 

最 后 ， 修 改 QuizActivity 中 的 checkAnswer(boolean) 方 法 ,确认 用 户 是 否 偷 看 答案 并 作 
出 相应 的 反应 。 基 于 mIsCheater 变 量 值 改变 toast 消 息 的 做 法 如 代码 清单 5-17 所 示 。 
代码 清单 5-17 基于 mIsCheater 变 量 值 改变 toast 消 息 ( QuizActivity.java ) 


@Override 
protected void onCreate(Bundle savedInstanceState) { 























mNextButton = (Button)findViewById(R.id.next button); 
mNextButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
mCurrentIndex = (mCurrentIndex + 1) % mQuestionBank.Length ; 
mIsCheater = false; 
updateQuestion(); 
} 
}); 
} 


private void checkAnswer(boolean userPressedTrue) { 
boolean answerIsTrue = mQuestionBank[mCurrentIndex] .isAnswerTrue(); 


int messageResId = 0; 


if (mIsCheater) { 
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messageResId = R.string.judgment_ toast; 


} elLse 
if (userPressedTrue == answerISTrue) { 
messageResId = R.string.correct toast ; 
} else { 


messageResId = R.string.incorrect toast,; 
} 
} 


Toast.makeText(this, messageResId, Toast.LENGTH_ SHORT) 
.Show(); 


运行 GeoQuiz 应 用 。 偷 看 一 下 答案 ， 看 看 会 发 生 什么 。 


5.4 ”activity 的 使 用 与 管理 


来 看 看 当 我 们 在 各 activity 间 往返 的 时 候 ,， 操作 系统 层面 到 底 发 生 了 什么 。 首 先 , 在 桌面 启动 
器 中 点 击 GeoQuiz 应 用 时 ， 操 作 系 统 并 没有 启动 应 用 ， 而 只 是 启动 了 应 用 中 的 一 个 activity。 确 切 
地 说 ， 它 启动 了 应 用 的 launcher activity。 在 GeoQuiz 应 用 中 ，QuizActivity 就 是 它 的 launcher 
activity。 

使 用 应 用 向 导 创 建 GeoQuiz 应 用 以 及 QuizActivity 时 ,QuizActivity 默 认 被 设置 为 launcher 
activity。 配 置 文件 中 ，QuizActivity 声 明 的 ijntent-filter 元 素 节点 下 ,可 看 到 QuizActivity 
被 指定 为 launcher activity， 如 代码 清单 5-18 所 示 。 


代码 清单 5-18 QuizActivity 被 指定 为 launcher activity ( AndroidManifest.xml ) 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
y 





















































<application 
二 


<activity android:name=" .QuizActivity"> 
<intent-fiLter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


<activity android:name=".CheatActivity" /> 
</activity> 
</application> 


</manifest> 


QuizActivity 实 例 出 现在 屏幕 上 后 , 用户 可 单 击 CHEAT! 按 钮 。CheatActivity 实 例 随即 在 
QuizActivity 实 例 上 被 启动 。 此 时 ， 它 们 都 处 于 activity 栈 中 ， 如 图 5-12 所 示 。 














92 第 5 章 第 二 个 activity 





GeoQuiz [en GeoQuiz 


GeoQuiz 


Canberra is the capital of Australia. Canberra is the capital of Australia， 








图 5-12”GeoQuiz 的 回 退 栈 


按 后 退 键 ，CheatActivity 实 例 被 弹出 栈 外 ，QuizActivity 重 新 回 到 栈 顶 部 ， 如 图 $-12 
所 示 。 

在 CheatActivity 中 调用 Activity.finish() 方 法 同样 可 以 将 CheatActivity 从 栈 里 弹出 。 

如 果 运 行 GeoQuiz 应 用 ,在 QuizActivity 界 面 按 后 退 键 ，QuizActivity 将 从 栈 里 弹出 ,我 
们 将 退回 到 GeoQuiz 应 用 运行 前 的 画面 ， 如 图 5-13 所 示 。 

















GeoQuiz 


ei 





图 5-13 ”后 退 返回 至 桌面 
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如 果 从 桌面 启动 器 启动 GeoQuiz 应 用 , 在 QuizActivity 界 面 按 后 退 键 , 将 退回 到 桌面 启动 器 
界面 ， 如 图 $-14 所 示 。 





GeoQuiz 


按 下 后 退 键 








图 $-14 “从 桌面 启动 器 启动 GeoQuiz 应 用 


在 桌面 启动 器 界面 ， 按 后 退 键 ， 将 返回 到 桌面 启动 器 启动 前 的 系统 界面 。 

至 此 ， 可 以 看 到 ，ActivityManager 维 护 着 一 个 非特 定 应 用 独 享 的 回 退 栈 。 所 有 应 用 的 
activity 都 共享 该 回 退 栈 。 这 也 是 将 ActivityManager 设 计 成 操作 系统 级 的 activity 管 理 器 来 负责 
启动 应 用 activity 的 原因 之 一 。 显 然 ， 回 退 栈 是 作为 一 个 整体 共享 于 操作 系统 及 设备 ， 而 不 单单 
用 于 某 个 应 用 。 

( 想 了 解 “向 上 ”按钮 ? 我 们 将 在 第 13 章 学 习 如 何 使 用 并 配置 它 。) 


5.5 ”挑战 练习 : 堵 住 漏洞 


作弊 者 是 注定 会 失败 的 。 当 然 ， 如 果 他 们 能 一 直 避 开 反 作弊 手段 ， 那 就 另 当 别论 了 。 正 所 谓 
道 高 一 尺 ， 魔 高 一 丈 ， 也 许 他 们 能 做 到 。 

GeoQuiz 应 用 有 些 大 漏洞 ， 你 的 任务 就 是 堵 住 它们 。 从 易 到 难 ， 以 下 为 待 解决 的 三 个 漏洞 。 
口 用 户 作 次 后 ， 可 以 旋转 CheatActivity 来 清除 作 浆 痕迹 。 
口 作 次 返回 后 ， 用 户 可 以 旋转 QuizActivity 来 清除 mIsCheater 变 量 值 。 
口 用 户 可 以 不 断 单 击 NEXT 按 钮 ， 跳 到 偷 看 过 答案 的 问题 ， 从 而 使 作弊 纪录 丢失 。 
祝 好 运 ! 

































































第 6 章 


Android SDK 版 本 与 羔 容 











开发 完 GeoQuiz 应 用 ,你 已 经 有 了 初步 的 开发 体会 。 本 章 中 , 我 们 学 习 Android 系 统 版 本 的 相 
关 知 识 。 在 学 习 本 书后 续 章 节 ， 以 及 应 对 未 来 实际 的 复杂 应 用 开发 时 ,你 就 会 明白 掌握 本 章 内 容 
有 多 么 重要 。 





6.1 Android SDK 版 本 


表 6-1 显 示 了 各 SDK 版 本 、 相 应 的 Android 固 件 版 本 ， 以 及 截至 2016 年 12 月 使 用 各 版 本 的 设备 
比例 。 





表 6-1 Android API 级 别 、 固 件 版 本 以 及 在 用 设备 比例 















































API 级 别 代 号 设备 固件 版 本 在 用 设备 比例 (%) 
24 Nougat 7.0 0.4 
23 Marshmallow 6.0 26.3 
22 Lollipop 5.1 23.2 
21 5.0 10.8 
19 KitKat 4.4 24.0 
18 4.3 1.9 
17 Jelly Bean 4.2 6.4 
16 4.1 4.5 
15 Ice Cream Sandwich (ICS ) 4.0.3，4.0.4 村 
10 Gingerbread 2.3.3 一 2.3.7 1.2 
8 Froyo 2 0.1 

* 注意 ， 本 表 已 忽略 比例 低 于 0.1% 的 在 用 设备 。 
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每 一 个 有 发 布 代号 的 版 本 随后 都 会 有 相应 的 增 量 版 本 。 例 如 ，Ice Cream Sandwich 最 初 的 发 
布 版 本 为 Android 4.0 ( API 14 级 )， 但 没 过 多 久 ，Android 4.0.3 及 4.0.4 (API 15 级 ) 的 增 量 发 行 版 
本 就 取代 了 它 。 

当然 ， 表 6-1 中 的 比例 会 动态 变化 ， 但 这 些 数字 已 揭示 一 种 重要 趋势 ， 即 新 版 本 发 布 后 ， 运 
行 老 版 本 的 Android 设 备 是 不 会 立即 进行 升级 或 更 换 的 。 截至 2016 年 12 月 , 超过 15% 的 设备 仍然 运 
行 着 Jelly Bean 或 更 早 版 本 的 系统 。Android 4.3 ( Jelly Bean 最 后 的 升级 版 本 ) 发 布 于 2013 年 10 月 。 
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( 感 兴趣 的 话 ， 可 去 http:/developerandroid.com/about/dashboards/index.html 查 看 表 6-1 数 据 的 
动态 更 新 。) 

为 什么 仍 有 这 么 多 设备 运行 着 老 版 本 Android 系 统 ? 主要 原因 在 于 Android 设 备 生产 商 和 运营 
商 之 间 的 激烈 竞争 。 每 个 运营 商都 希望 拥有 专属 定制 机 。 设备 生 产 商 也 有 同样 的 压力 一 一 所 有 和 手 
机 都 基于 相同 的 操作 系统 ， 而 他 们 又 想 与 众 不 同 。 最终 ， 届 服 于 市 场 和 运营 商 的 双重 压力 ， 各 种 
专属 的 、 无 法 升级 的 定制 版 Android 设 备 涌 向 市 场 , 令 人 眼花 综 乱 、 目 不 上 暇 接 。 
定制 版 Android 设 备 不 能 运行 Google 发 布 的 新 版 本 Android 系 统 。 因 此 ， 用 户 只 能 寄 望 于 定制 
版 的 兼容 升级 。 然 而 ， 即 便 可 以 获得 这 种 升级 ,通常 也 是 Google 新 版 本 发 布 后 数 月 的 事情 了 。 生 
产 商 往往 更 愿意 投入 资源 推出 新 设备 ， 而 不 是 持续 升级 旧 设 备 。 


















































6.2 ”Android 编程 与 兼容 性 问题 


各 种 设备 迟缓 的 版 本 升级 再 加 上 Google 定 期 的 新 版 本 发 布 ， 给 Android 编 程 带 来 了 严重 的 如 
容 性 问题 。 为 扩大 市 场 份额 ， 对 于 运行 KitKat 、Lollipop 、Marshmallow 、Nougat 以 及 任何 最 新 版 
本 的 Android 设 备 (还 要 考虑 各 种 尺寸 )，Android 开 发 人 员 必 须 保证 应 用 都 能 兼容 。 

还 好 ， 开 发 应 用 时 ， 不 同 尺 寸 设 备 的 处 理 要 比 想象 中 的 简单 。 手 机 屏幕 尺寸 虽然 繁多 ， 但 
Android 布 局 系统 为 编程 适 配 做 了 很 好 的 工作 。 平 板 设 备 处 理 起 来 会 复杂 一 些 ， 但 配置 修饰 符 可 
用 来 处 理 屏 幕 适 配 〈 详 见 第 17 章 )。 不 过 ， 对 于 同样 运行 着 Android 系 统 的 Android TV 和 Android 
Wear 设 备 ， 由 于 UI 差 异 太 大 ， 应 用 的 交互 模式 和 设计 通常 需要 重新 考虑 。 


6.2.1 比较 合理 的 版 本 


本 书 支持 的 最 老 版 本 是 API 19 级 ( KitKat )。 虽然 还 在 支持 , 但 我 们 更 应 该 将 精力 投入 在 较 新 
系统 版 本 上 (API 19+ 级 )。 当 前 ，Gingerbread 、Ice Cream Sandwich 和 Jelly Bean 系 统 版 本 的 市 场 
份额 正 逐 月 下 降 ， 还 在 这 些 老 设 备 上 投入 过 多 显然 得 不 偿 失 。 

对 于 增 量 版 本 ， 向 下 兼容 一 般 问题 不 大 。 主 要 版 本 向 下 兼容 才 是 大 麻烦 。 也 就 是 说 ， 仅 支持 
5.x 版 本 的 工作 量 不 大 ,但 需要 支持 到 4.x 的 话 ， 考 虑 到 这 么 多 不 同 版 本 的 差异 ， 工 作 量 就 相当 大 
了 。 谢 天 谢 地 ，Google 提 供 了 一 些 兼 容 库 ， 大 大 降低 了 开发 难度 。 后 续 章 节 会 介绍 具体 内 容 。 

Honeycomb 版 本 的 发 布 是 Android 世 界 的 一 个 分 水 岭 ， 该 版 本 引入 了 全 新 的 UI 和 构造 组 件 。 
Honeycomb 起 初 只 面向 平板 设备 开发 ， 所 以 直到 发 布 Ice Cream Sandwich， 这 些 新 功能 才 正 式 发 
布 给 终端 用 户 使 用 。 随 后 它 又 经 历 了 几 次 增 量 版 本 升级 。 

尽管 Android 以 及 第 三 方 库 提 供 了 大 量 的 兼容 性 编程 支持 ， 但 兼容 性 问题 已 实 实 在 在 地 增加 
了 学 习 的 复杂 性 。 
新 建 GeoQuiz 项 目 时 ， 在 新 建 应 用 向 导 界 面 ， 我 们 设置 过 最 低 SDK 版 本 ， 如 图 6-1 所 示 。( 注 
意 ，Android 的 “SDK 版 本 ”和 “API 级 别 ” 二 词 可 以 交替 使 用 。) 
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(ER | Create New Project 


Target Android Devices 





Select the form factors your app will run on 


Different platforms may require separate SDKs 


Phone and Tablet 


Minimum SDK _ API 19: Android 4.4 (KitKat) 
Lower APl levels target more devices, but have fewer features available. 
By targeting API 19 and later, your app will run on approximately 73.9% of the devices 
that are active on the Google Play Store. 
Help me choose 
| Wear 
Minimum SDK API 21: Android 5.0 (Lollipop) 仿 
JIV 
Minimum SDK API 21: Android 5.0 (Lollipop) 访 


Android Auto 


Cancel | | Previous EL rs 





图 6-1 创建 新 项 目 向 时， 还 有 印象 吗 




















除了 最 低 支持 版 本 , 还 可 以 设置 目标 版 本 和 编译 版 本 。 下 面 来 看 看 都 有 哪些 默认 选项 ,以 及 
新 建 项 目 时 该 如 何 选择 。 

所 有 的 设置 都 保存 在 应 用 模块 的 build.gradle 文 件 中 。 编 译 版 本 独占 该 文件 。 虽然 最 低 版 本 和 
目标 版 本 也 设置 在 该 文件 中 ， 但 它们 的 作用 是 覆盖 和 设置 配置 文件 AndroidManifestxml。 

打开 应 用 模块 下 的 build.gradle 文 件 ， 查 看 compileSdkVersion 、minSdkVersion 和 
targetSdkversion 的 属性 值 ， 如 代码 清单 6-1 所 示 。 


代码 清单 6-1 查看 编译 配置 (app/build.gradle ) 


compileSdkVersion 25 
buildToolsVersion "25.0.0" 








defaultConfig { 


applicationId "com.bignerdranch.android.geoquiz" 
minSdkVersion 19 
targetSdkVersion 25 


6.2.2 ”SDK 最 低 版 本 
以 最 低 版 本 设置 值 为 标准 ， 操 作 系 统 会 拒绝 将 应 用 安装 在 系统 版 本 低 于 标准 的 设备 上 。 
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例如 ， 设 置 版 本 为 API 19 级 ( KitKat )， 便 赋予 了 系统 在 运行 KitKat 及 以 上 版 本 的 设备 上 安 
装 GeoQuiz 应 用 的 权限 。 而 在 运行 诸如 Jelly Bean 版 本 的 设备 上 ， 系 统 会 拒绝 安装 GeoQuiz 应 用 。 

再 看 表 6-1 ， 你 就 会 明白 为 什么 选 KitKat 作为 SDK 最 低 版 本 比较 合适 ， 因 为 有 超过 80% 的 在 
用 设备 支持 安装 此 应 用 。 





6.2.3” SDK 目标 版 本 


目标 版 本 的 设 定 值 告知 Android: 应 用 是 为 哪个 API 级 别 设 计 的 。 大 多 数 情况 下 ， 目 标 版 本 即 
最 新 发 布 的 Android 版 本 。 

什么 时 候 需 要 降低 SDK 目标 版 本 呢 ? 新 发 布 的 SDK 版 本 会 改变 应 用 在 设备 上 的 显示 方式 , 其 
至 连 操作 系统 后 台 运 行 行为 都 会 受 影 响 。 如 果 应 用 已 开发 完成 , 应 确认 它 在 新 版 本 上 能 和 否 如 预期 
那样 正常 运行 。 查 看 http://developer.android.com/reference/android/os/Build.VERSION_CODES.html 
上 的 文档 , 检查 可 能 出 现 问题 的 地 方 。 根 据 分 析 结 果 ， 要 么 修改 应 用 以 适应 新 版 本 系统 ， 要 么 降 
低 SDK 目 标 版 本 。 

降低 SDK 目 标 版 本 可 以 保证 的 是 ， 即便 在 高 于 目标 版 本 的 设备 上 , 应 用 仍然 可 以 正常 运行 , 且 
运行 行为 仍 和 目标 版 本 保持 一 致 。 这 是 因为 新 发 布 版 本 中 的 变化 已 被 忽略 。 















































6.2.4 ”SDK 编译 版 本 


代码 清单 6-1 中 , 第 1 行 标 为 compitesdkversion 的 是 SDK 编 译 版 本 设置 。 该 设置 不 会 出 现在 
manifest 配 置 文 件 里 。SDK 最 低 版 本 和 目标 版 本 会 通知 给 操作 系统 ， 而 SDK 编 译 版 本 只 是 你 和 编 
译 右 之 间 的 私有 信息 。 

Android 的 特色 功能 是 通过 SDK 中 的 类 和 方法 展现 的 。 在 编译 代码 时 ，SDK 编 译 版 本 ( 即 编 
译 目标 ) 指定 具体 要 使 用 的 系统 版 本 。Android Studio 在 寻找 类 包 导 入 语句 中 的 类 和 方法 时 ， 编 
译 目标 确定 具体 的 基准 系统 版 本 。 

编译 目标 的 最 佳 选 择 为 最 新 的 API 级 别 〈 当前 级 别 为 23 ， 代 号 为 Nougat )。 当 然 ， 需 要 的 话 ， 
也 可 以 改变 应 用 的 编译 目标 。 例 如 ，Android 新 版 本 发 布 时 ， 可 能 就 需要 更 新 编译 目标 ， 以 便 使 
用 新 版 本 引入 的 方法 和 类 。 

可 以 修改 build.gradle 文 件 中 的 SDK 最 低 版 本 、 目 标 版 本 以 及 编译 版 本 。 修 改 完毕 ， 项 目 和 
Gradle 更 改 重新 同步 后 才能 生效 。 选 择 Tools 一 Android 一 > Sync Project with Gradle Files 菜 单项 ， 
项 目 随 即 会 重新 编译 。 


6.2.5 安全 添加 新 版 本 API 中 的 代码 


GeoQuiz 应 用 的 SDK 最 低 版 本 和 编译 版 本 间 的 差异 较 大 ， 由 此 带 来 的 兼容 性 问题 需要 处 理 。 
例如 , 在 GeoQuiz 应 用 中 ,如果 调 用 了 KitKat ( API 19 级 ) 以 后 的 SDK 版 本 中 的 代码 会 怎么 样 呢 ? 
结果 显示 ,在 KitKat 设备 上 安装 运行 时 ， 应 用 会 崩 演 。 

这 个 问题 可 以 说 是 曾经 的 测试 吐 梦 。 然 而 ， 受 益 于 Android Lint 的 不 断 改 进 ， 现 在 在 老 版 本 
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系统 上 调用 新 版 本 代码 时 ， 潜 在 问题 在 编译 时 就 能 被 发 现 。 也 就 是 说 ， 如 果 使 用 了 高 版 本 系统 
API 中 的 代码 ，Android Lint 会 提示 编译 错误 。 

目前 ，GeoQuiz 应 用 中 的 简单 代码 都 来 自 于 API 19 级 或 更 早 版 本 。 现 在 ， 我 们 来 增加 API 21 
级 (Lollipop ) 的 代码 ， 看 看 会 发 生 什么 。 

打开 CheatActivity.java 文 件 , 在 SHOW ANSWER 按 钮 的 OnCLickListener 方 法 中 , 添加 代码 
清单 6-2 所 示 代 码 ， 从 而 在 隐藏 按钮 的 同时 ， 显 示 一 段 圆 球 特效 动画 。 


代码 清单 6-2 ”添加 动画 特效 代码 ( CheatActivity.java ) 


mShowAnswerButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
if (mAnswerIsTrue) { 
mAnswerTextView.setText(R.string.true button); 
} else { 
mAnswerTextView.setText(R.string.false button); 





























} 


setAnswerShownResult (true); 


int cx = mShowAnswerButton.getwidth() / 2; 
int cy = mShowAnswerButton.getHeight() / 2; 
float radius = mShowAnswerButton.getWidth(); 
Animator anim = ViewAnimationUtils 
‘CreateCircularReveal (mShowAnswerButton, cx, cy, radius, 0); 
anim.addListener(new AnimatorListenerAdapter() { 
@Override 
public void onAnimationEnd(Animator animation) { 
super.onAnimationEnd(animation); 
mShowAnswerButton.setVisibility (View.INVISIBLE); 
} 
}); 


anim.start(); 
} 
}); 


传人 一 些 特定 参数 ，createCircuLarRevealt 方 法 创建 了 一 个 Animator。 首 先 ， 指 定 要 显 
示 或 隐藏 的 View,， 然 后 是 动画 的 中 心 位 置 、 起 始 半径 和 结束 半径 。 为 隐藏 按钮 ,这 里 将 它 的 起 始 
半径 设置 为 按钮 宽度 ， 结 束 半径 设置 为 0。 

动画 启动 前 ， 设 置 一 个 监听 器 ， 确 定 动画 何 时 播 完 。 动 画 一 结束 ， 就 显示 答案 并 隐藏 按钮 。 

最 后 播放 动画 ， 看 看 效果 。 有 关 Android 动 画 方面 的 知识 将 在 第 32 章 学 习 。 

Android 直 到 SDK API 21 级 才 加 入 ViewAnimationUtils 类 和 它 的 createCircularReveal 
方法 。 因 此 ， 上 述 代码 在 低 版 本 设备 上 运行 时 会 出 问题 。 

输入 代码 清单 6-2 所 示 代 码 时 ，Android Lint 会 立即 提示 ， 这 段 代码 对 于 最 低 版 本 SDK 是 不 安 
全 的 。 如 果 没 看 到 提示 ， 请 选择 Analyze 一 Inspect Code.... 菜 单项 手动 触发 Lint。 因 为 SDK 编 译 版 
本 为 API21 级 ,编译 器 本 身 编译 代码 没有 问题 ， 而 Android Lint 知 道 项 目 SDK 最 低 版 本 ， 所 以 及 时 指 
出 了 问题 。 
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虽然 Lint 提 示 了 类 似 Call requires API level 21 (Currentmin is 19) 的 警告 信息 ， 但 是 你 可 以 忽略 


它 。 不 过 ， 出 了 问题 可 别 怪 Lint 没 有 提醒 你 。 
该 怎么 消除 这 些 错 误 信息 呢 ? 一 种 办 法 是 提升 SDK 最 低 版 本 到 21。 然 而 , 提升 SDK 最 低 版 本 
只 是 回避 了 兼容 性 问题 。 如 果 应 用 不 能 安装 在 API 19 级 和 更 老 版 本 设备 上 ， 那么 也 就 不 存在 新 老 


系统 的 兼容 性 问题 了 。 因 此 ， 实 际 上 这 并 没有 真正 解决 兼容 性 问题 。 
比较 好 的 做 法 是 将 高 API 级 别 代码 置 于 检查 Android 设 备 版 本 的 条 件 语句 中 ， 如 代码 清单 6-3 


所 示 。 
代码 清单 6-3 ”首先 检查 设备 的 编译 版 本 


mShowAnswerButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
if (mAnswerIsTrue) { 
mAnswerTextView.setText(R.string.true button); 


} else { 
mAnswerTextView.setText(R.string.false button); 

































































setAnswerShownResult (true); 


if (Build.VERSION.SDK_INT >= Build.VERSION CODES.LOLLIPOP) { 
int cx = mShowAnswerButton.getwidth() / 2; 
int cy = mShowAnswerButton.getHeight() / 2; 
float radius = mShowAnswerButton.getwidth(); 
Animator anim = ViewAnimationUtils 
.CreateCircularReveal (mShowAnswerButton, cx, cy, radius, 0); 


anim.addListener(new AnimatorListenerAdapter() { 


@Override 
public void onAnimationEnd(Animator animation) { 


super.onAnimationEnd(animation); 
mShowAnswerButton.setVisibility(View.INVISIBLE); 
} 
}); 


anim.start(); 


} else{ 
mShowAnswerButton.setVisibility(View.INVISIBLE); 


} 
} 
}); 


Build .VERSION.SDK_INT 常 量 代 表 了 Android 设 备 的 版 本 号 。 可 将 该 常量 同 代表 Lollipop 版 本 
的 常量 进行 比较 。( 版 本 号 清单 可 参看 网 页 http://developer.android.com/reference/android/os/Build. 
VERSION CODES.html。) 
现在 动画 特效 代码 只 有 在 API 21 级 或 更 高 版 本 的 设备 上 运行 应 用 才 会 被 调用 。 应 用 代码 在 
API 19 级 设备 上 终于 安全 了 ，Android Lint 应 该 也 满意 了 吧 。 
在 Lollipop 或 更 高 版 本 的 设备 上 运行 GeoQuiz 应 用 。 启动 CheatActivity 时 , 确认 看 到 了 想 要 


的 动画 特效 。 
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也 可 以 在 KitKat 设 备 ( 虚拟 或 实体 ) 上 运行 GeoQuiz 应 用 。 当 然 ， 动 画 特 效 是 看 不 到 了 , 但 
可 验证 应 用 仍 能 正常 运行 。 


6.3 使 用 Android 开发 者 文档 


从 Android Lint 错 误 信 息 中 可 看 到 不 兼容 代码 所 属 的 API 级 别 。 也 可 在 Android 开 发 者 文档 里 
查看 各 API 级 别 特有 的 类 和 方法 。 

越 早 熟悉 使 用 开发 者 文档 越 有 利于 开发 。 没 人 能 记 住 Android SDK 中 的 海量 信息 ， 更 不 
要 说 定期 发 布 的 新 版 本 系统 了 。 因 此 ， 学 会 查阅 SDK 文 档 ， 不 断 学 习 新 的 知识 尤 显 重要 。 

Android 开 发 者 文档 是 优秀 而 丰富 的 信息 来 源 。 文档 主页 是 http://developer.android.com/。 文档 
分 为 三 大 部 分 ， 即 设计 、 开 发 和 发 布 。 设 计 部 分 的 文档 包括 应 用 UI 设计 的 模式 和 原则 。 开 发 部 分 
包括 SDK 文 档 和 培训 资料 。 发 布 部 分 讲述 如 何在 Google Play 商 店 里 或 以 开放 发 布 模式 准备 并 发 布 
应 用 。 有 机 会 的 话 ， 一 定 要 仔细 研读 这 些 资料 。 

开发 部 分 又 细 分 为 七 大 块 内 容 。 
口 Android 培 训 : 初级 和 中 级 开发 者 的 培训 模块 ， 包 括 可 下 载 的 示例 代码 。 
口 API 使 用 指南 : 基于 主题 的 应 用 组 件 、 特 色 功 能 详 述 以 及 它们 的 最 佳 实践 。 
口 参考 文档 : SDK 中 类 、 方 法 、 接 口 、 属 性 常量 等 可 搜索 、 交 叉 链 接 的 参考 文档 。 
口 示例 代码 : 如 何 使 用 各 种 API 的 示例 代码 。 
口 Android Studio: 与 Android Studio IDE 相 关 的 内 容 。 
口 Android NDK: 有 关 Android 原 生 开发 工具 的 介绍 和 参考 链接 ,该 工具 允许 开发 人 员 使 用 C 
或 C++ 开发 应 用 。 
口 Google 服 务 : Google 专 属 API 的 相关 信息 ， 包 括 Google 地 图 和 Google 云 消息 。 

Android 文 档 可 脱 机 查看 。 浏览 SDK 安 装 文件 所 在 目录 , 找到 docs 目 录 。 该 目录 包含 了 全 部 的 
Android 开 发 者 文档 内 容 。 

例如 ， 为 确定 ViewAnimationUtils 类 所 属 的 API 级 别 ， 使 用 文档 浏览 器 右上 角 的 搜索 框 搜 
索 它 。 搜索 结果 显示 有 多 种 类 别 的 信息 。 你 想 要 的 结果 位 于 参考 文档 部 分 ( 注意 灵活 使 用 左边 的 
搜索 过 滤 功 能 )。 

选择 第 一 条 结果 ,进入 ViewAnimationUtils 类 的 参考 文档 页 面 ， 如 图 6-2 所 示 。 该 页 面 项 部 
的 链接 可 以 链接 到 不 同 的 部 分 。 

向 下 滚动 ， 找 到 并 点 击 createCircularReveal(,..) 方 法 查看 具体 的 方法 描述 。 从 该 方法 
名 的 右边 可 以 看 到 ，createCircularReveal(,,.) 方 法 最 早 被 3 引入 的 API 级 别 是 API 21 级 。 

如 果 想 查看 ViewAnimationUtils 类 的 哪些 方法 可 用 于 API 19 级 ， 可 按 API 级 别 过 滤 引 用 。 
在 页 面 左 边 按 包 索 引 的 类 列表 上 方 ， 找 到 API 级 别 过 滤 框 ， 目 前 它 显示 为 APIlevel: 21。 展 开 下 拉 
表单 ， 选 择 数字 19。 一 般 而 言 ， 所 有 API 19 级 以 后 引入 的 方法 都 会 被 过 滤 掉 ， 并 自动 变 为 灰色 。 
ViewAnimationUtils 类 是 在 API 21 级 引入 的 ， 所 以 ， 可 以 看 到 一 条 该 类 无 法 用 于 API 19 级 的 警 
示 信 息 。 
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咏 !ViewAnimationUtils | Andr- x 了、 3 


€ SC ( developerandroid.com/reference/android/view/ViewAnimationUtils.html 空 | 三 











嘱 ! Developers ~ Design Develop Distribute Q 





Training API Guides Reference Tools Google Services Samples 


Android APIs APllevel: 21 : public final class 本 Summary: Methods Newed Mathode ERand Al 
二 ViewAnimationUtils Added 
android.test 

android.test.mock extends Object 


android.test.suitebuilder 

android.test.suitebuilder.annotat ahh TR 
android.text 2 
android.text.format 

android.text.method 1 
android.text.style | Class Overview 
android.text.util 
android.transition 
android.util 
android.view 


android.view.accessibility 
= Summary 


Defines common utilities for working with View's animations. 





ScaleGestureDetector Public Methods 
ScaleGestureDetector.SimpleOnt 二 
SoundEffectConstants static Animator createCircularReveal (View view, int centerX, int centerY, float startRadius, float endRadius) 
Surface Returns an Animator which can animate a clipping circle. 

SurfaceView 


TextureView Inherited Methods 


TouchDelegate 
VelocityTracker b From class java.lang.Object 


View 

View.AccessibilityDelegate 

View.BaseSavedState 和 
View.DragShadowBuilder B U b | IC M et hod S 
View.MeasureSpec 





Use Tree Navigation "| public static Animator createCircularReveal (View view, int centerX, int centerY, float startRadius, float 


图 6-2 ”ViewAnimationUtils 参 考 文档 页 面 


API 级 别 过 滤 非 常 有 用 ， 可 以 让 你 知道 应 用 要 用 到 的 类 在 哪个 API 级 别 可 用 。 例 如 ， 在 参考 
文档 页 搜索 Activity 类 ， 以 API 19 级 过 滤 。 结 果 显 示 ， 诸 如 onEnterAnimationCompLete 的 很 
多 方法 是 在 API 19 级 才 开始 添加 的 。 而 在 Lollipop SDK 中 ，onEnterAnimationComplete 属 于 附 
加 方法 ， 为 activity 间 的 跳 转 提供 了 有 趣 的 过 场 动画 效果 。 

在 后 续 章 节 的 学 习 过 程 中 , 一 定 要 经 带 查 阅 开发 者 文档 。 完 成 章 末 的 挑战 练习 ， 以 及 探究 某 
些 类 、 方 法 或 其 他 主题 时 ， 都 需要 查阅 相关 的 文档 资料 。Google 还 在 不 断 地 更 新 和 改进 Android 
文档 ， 新 知识 和 新 概念 也 因此 不 断 涌现 ， 学 无 止境 啊 。 


6.4 ”挑战 练习 : 报告 编译 版 本 


在 GeoQuiz 应 用 的 页 面 布局 上 添加 一 个 TextView 组 件 , 向 用 户 报 告 设备 运行 系统 的 API 级 别 ， 
如 图 6-3 所 示 。 
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GeoQuiz 





Are you sure you want to do this? 


SHOW ANSWER 


APl Level 25 








图 6-3 ”完成 后 的 用 户 界 面 
应 用 运行 时 才能 知道 设备 的 编译 版 本 ,所 以 不 能 直接 在 布局 上 设置 TextView 值 .打开 Android 
文档 中 的 TextView 参 考 文档 页 ， 查 找 TextView 的 文本 赋值 方法 。 寻 找 可 以 接受 字符 串 或 
CharSequence 的 单 参数 方法 。 
另外 ， 可 使 用 TextView 参 考 文档 里 列 出 的 其 他 XML 属性 来 调整 文本 的 尺寸 或 样式 。 


6.5 ”挑战 练习 : 限制 作弊 次 数 


允许 用 户 最 多 作 痊 3 次 。 记录 用户 从 看管 案 的 次 数 , 在 CHEAT 按 钮 下 显示 剩余 次 数 。 超出 后 ， 
禁用 偷 看 按钮 。 





























UlIfragment 与 fragment 


管理 器 








本 章 ,， 我 们 开始 开发 一 个 名 为 CriminalIntent 的 应 用 。 该 应 用 可 详细 记录 各 种 办 公 室 陋习 ， 如 
随手 将 脏 盘 子 丢 在 休息 室 水池 里 ,或 者 自己 打印 完 文件 就 走 ， 全 然 不 顾 公共 打印 机 里 已 缺 纸 等 。 
CriminalIntent 应 用 记载 的 陋习 记录 包括 标题 、 日 期 和 照片 ,支持 在 联系 人 中 查找 当事人 , 通过 
E-mail 、Twitter、Facebook 或 其 他 应 用 提出 抗议 。 看 见 陋习 ， 记 录 下 来 ,舒缓 了 心情 ， 就 可 以 继 
续 专 心 做 手头 上 的 工作 。 真 是 个 不 错 的 应 用 。 
CriminalIntent 应 用 比较 复杂 ， 需 要 13 章 的 篇 幅 来 完成 。 应 用 的 用 户 界面 由 列表 以 及 记录 明细 
组 成 。 主 屏幕 会 显示 已 记录 陋习 的 列表 清单 。 用 户 可 新 增 记录 或 查看 和 编辑 现 有 记录 ， 如 图 7-1 
所 示 。 
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Criminallntent 十 sHowsuBTITLE € Criminallntent 
Scooter stolen while going to the restroom TITLE 
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Scooter stolen while going to the 








Paper clip Ponzi scheme ® restroom 
oO 商 

Tue Jun 28 05:36:04 EDT 2016 

Instagram photos at beach on sick day DETAILS 


Wyssbo D0 D291 SUN MAY 29 15:50:01 EDT 2016 


Fragment fraud 口 soved 


Wed Nov 30 22:18:27 EST 2016 
CHOOSE SUSPECT 
Popcorn left unattended, microwave on 9o 


fire SEND CRIME REPORT 


Mon Dec12 13:47:11 EST 2016 














图 7-1 CriminalIntent， 一 个 列表 明细 类 应 用 
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7.1 UI 设计 的 灵活 性 需求 


你 可 能 认为 , 开发 一 个 由 两 个 activity 组 成 的 列表 明细 类 应 用 就 行 了 , 一 个 activity 负 责 管理 记 
录 列 表 界 面 ， 另 一 个 负责 管理 记录 明细 界面 。 点 击 列表 中 某 条 记录 会 启动 其 明细 activity 实 例 , 按 
后 退 键 会 销毁 明细 activity 并 返回 到 记录 列表 activity 界 面 。 想 看 下 条 记录 ， 同 样 操作 。 
理论 上 这 想法 行 得 通 ， 但 如 果 需 要 更 复杂 的 用 户 界 面 呈现 及 跳 转 ， 怎 么 办 呢 ? 
口 假设 用 户 正 在 平板 设备 上 运行 CriminalIntent 应 用 。 平板 以 及 大 尺寸 手机 的 屏幕 较 大 , 能 够 
同时 显示 列表 和 记录 明细 ( 最 起 码 在 横 屏 模式 下 是 这 样 )， 如 图 7-2 所 示 。 


手机 平板 















































列表 记录 明细 记录 明细 














图 7-2 手机 和 平板 上 理想 的 列表 明细 界面 


口 假设 用 户 正 在 手机 上 查看 记录 明细 信息 ， 并 想 查 看 列表 中 的 下 一 条 记录 信息 。 如 果 无 需 
返回 列表 界面 ， 滑 动 屏 幕 就 能 查看 下 一 条 记录 就 好 了 。 每 滑动 一 次 屏幕 ， 应 用 便 自动 切 
换 到 下 一 条 记录 明细 。 
可 以 看 出 , 灵活 多 变 的 UI 设计 是 以 上 假设 情景 的 共同 点 。 也 就 是 说 , 为 了 适应 用 户 或 设备 的 
需求 ，activity 界 面 可 以 在 运行 时 组 装 ， 其 至 重新 组 装 。 
activity 自 身 并 不 具有 这 样 的 灵活 性 。activity 视 图 可 以 在 运行 时 切换 , 但 控制 视图 的 代码 必须 
在 activity 中 实现 。 结 果 ， 各 个 activity 还 是 得 和 特定 的 用 户 界面 紧 紧 绑 定 。 



















































































7.2 引入 fragment 


采用 fragment 而 不 是 activity 来 管理 应 用 UI， 可 绕 开 Android 系 统 activity 使 用 规则 的 限制 。 

fragment 是 一 种 控制 器 对 象 ，activity 可 委派 它 执行 任务 。 这 些 任务 通常 就 是 管理 用 户 界面 。 
受 管 的 用 户 界面 可 以 是 一 整 屏 或 是 整 屏 的 一 部 分 。 

管理 用 户 界 面 的 fagment 又 称 为 UI fragment。 它 自己 也 有 产生 于 布局 文件 的 视图 。fragment 
视图 包含 了 用 户 可 以 交互 的 可 视 化 UI 元 素 。 

activity 视 图 能 预 留 位 置 供 fragment 视 图 插入 。 本 章 只 需要 插入 一 个 fragment。 如 果 有 多 个 
fragment 要 搬入 ，activity 视 图 就 提供 多 个 位 置 。 

根据 应 用 和 用 户 的 需求 ， 可 联合 使 用 fragment 及 activity 来 组 装 或 重组 用 户 界 面 。 在 整个 生命 
周期 过 程 中 ，activity 视 图 还 是 那个 视图 。 因 此 不 必 担 心 会 违反 Android 系 统 的 activity 使 用 规则 。 
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下 面 来 看 看 应 用 该 如 何 支 持 同 屏 显 示 列 表 与 明细 内 容 。 实际 上 , 这 类 应 用 的 activity 视 图 由 列 
表 fragment 和 明细 fragment 组 成 。 明 细 视 图 负责 显示 列表 项 的 明细 内 容 。 

选择 不 同 的 列表 项 就 显示 对 应 的 明细 视图 ，activity 负 责 以 一 个 明细 fragment 替 换 男 一 个 明 
细 fragment， 如 图 7-3 所 示 。 这 样 ， 视 图 切换 的 过 程 中 ,也 不 用 销毁 activity 了 。 有 fragment 助 阵 ， 
一 切 就 这 么 简单 。 


























列表 用 户 点 击 不 同 的 列表 项 
fragment fragment oo fragment 1! 
获取 新 的 fragment 
以 显示 列表 项 明细 
activity 的 视图 activity 的 视图 





图 7-3 ”明细 fragment 的 切换 


除 列表 明细 类 应 用 外 ,使 用 UIfragment 将 应 用 的 UI 分 解 成 构建 块 ,还 适用 于 其 他 类 型 的 应 用 。 
例如 ， 利 用 单个 构建 块 ， 可 以 方便 地 构建 分 页 界面 、 动 画 侧 边 栏 界 面 等 更 多 定制 界面 。 

你 还 会 在 第 11 章 和 第 17 章 中 体会 到 fragment 的 妙 处 。 不 过 ，UI 设 计 得 这 样 灵活 也 是 要 付出 代 
价 的 ， 即 更 复杂 的 应 用 、 更 多 的 部 件 以 及 大 量 的 实现 代码 。 现 在 先 来 感受 它 复杂 的 一 面 。 


























7.3 着手 开发 Criminallntent 
CriminalIntent 应 用 比较 复杂 ， 第 一 步 先 开发 应 用 的 记录 明细 部 分 。 完 成 后 的 界面 如 图 7-4 所 示 。 


Criminalintent 





Enter a title for the crime. 























图 7-4 本 章 结 束 时 ，CriminalIntent 应 用 的 界面 
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首先 设计 一 个 名 为 CrimeFragment 的 UIfragment 来 管理 图 7-4 所 示 的 用 户 界面 , 再 设计 一 个 名 
为 CrimeActivity 的 activity 来 托管 CrimeFragment 实 例 。 

可 以 这 样 理解 托管 : activity 在 其 视图 层级 里 提供 一 处 位 置 ， 用 来 放置 fragment 视 图 ， 如 图 7-5 
所 示 。fragment 本 身 没有 在 屏幕 上 显示 视图 的 能 力 。 因 此 ， 只 有 将 它 的 视图 放置 在 activity 的 视图 
层级 结构 中 ，fragment 视 图 才能 显示 在 屏幕 上 。 




























CrimeActivity 


bs 
activity_crime.xml 










CrimeFragment 


K | fragment_crime.xml 





onTextChanged() 


onCheckedChanged() 





图 7-5 ”CrimeActivity 托 管 着 CrimeFragment 


CriminalIntent 是 个 大 型 项 目 ， 借 助 对 象 图 解 可 以 更 好 地 理解 它 。 图 7-6 展 示 了 CriminalIntent 
项 目 涉 及 的 对 象 以 及 对 象 间 的 关系 。 可 以 不 去 记忆 , 但 开工 前 , 整体 了 解 开 发 目标 将 非常 有 帮助 。 


模型 





Crime 


mTitle 
mld 








控制 器 mCrime 


CrimeActivity 





mDateButton mTitleField 
mSolvedCheckbox 


视图 (布局) textChangedListener 


Button 
(crime_date) 





checkedChangedListener 
EditText FrameLayout 
(crime titile) (fragmentContainer) 


图 7-6 ”CriminalIntent 应 用 的 对 象 图 解 ( 本 章 应 完成 部 分 ) 


Checkbox 
(crime_solved) 
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可 以 看 到 ，CrimeFragment 的 作用 与 activity 在 GeoQuiz 应 用 中 的 作用 差不多 ， 都 负责 创建 并 
管理 用 户 界 面 ， 以 及 与 模型 对 象 进 行 交 互 。 

图 7-6 中 的 Crime、 RE A 个 类 。 

Crime 实例 代表 某 种 办 公 室 陋习 。 在 本 章 中 ， 一 个 crime 有 一 个 标题 、 一 个 标识 ID 、 一 个 日 期 
和 一 个 布尔 值 。 布尔 值 用 于 表示 陋习 是 否 被 解决 。 标 题 是 一 段 描述 性 名 称 ， 如 “向 水 柳 中 倾倒 有 
毒物 ”或 “ 某 人 偷 了 我 的 酸奶 !” 等 。 标 识 ID 是 识别 Crime 实 例 的 唯一 元 素 。 

简单 起 见 ， 本 章 只 使 用 一 个 crime 实 例 ， 并 将 其 存放 在 CrimeFragment 类 的 成 员 变 量 
(mCrime ) 中 。 

CrimeActivity 视 图 由 FrameLayout 组 件 组 成 ，FrameLayout 组 件 为 CrimeFragment 视 图 安 
排 了 显示 位 置 。 

CrimeFragment 视 图 由 一 个 LinearLayout 组 件 及 其 三 个 子 视图 组 成 。 这 三 个 子 视图 包括 一 
et 一 个 Button 组 件 和 一 个 CheckBox 组 件 。CrimeFragment 类 中 有 存储 它们 的 成 

变量 ， 并 设 有 监听 器 ， 会 响应 用 户 操作 时 ， 更 新 模型 层 数据 。 












































7.3.1 创建 新 项 目 


让 绍 了 这 么 多 ， 是 时 候 创 建新 应 用 了 。 选 择 File 一 New 一 New Project... 菜 单项 创建 新 的 
ee 用 。 如 图 7-7 所 示 ， 将 应 用 命名 为 CriminalIntent， 并 在 Company Domain 一 栏 填 入 
androld.bignerdranch.com。 








加 © Create New Project 





G2 New Project 


b Android Studio 


Configure your new project 


Application name: “Criminallntent 


Company Domain: android.bignerdranch.com 


Package name: com.bignerdranch.android.criminalintent 


Include C++ Support 


Project location: /Users/dev/AndroidStudioProjects/Criminalintent 





图 7-7 创建 CriminalIntent 应 用 
单 击 Next 按 钮 ， 指 定 SDK 最 低 版 本 为 API 19: Android 4.4， 并 确认 仪 勾 选 了 Phone and Tablet 
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设备 类 型 。 
单 击 Next 按 钮 ， 选 择 新 增 Empty Activity ， 单 击 Next 继 续 。 
最 后 ， 命 名 activity 为 CrimeActivity， 单 击 Finish 按 钮 完成 ， 如 图 7-8 所 示 。 


人 © Create New Project 


yx Customize the Activity 


Creates a new empty activity 
Activity Name: CrimeActivity 
GentCrimeActivitye 


Layout Name: activity_crime 


Backwards Compatibility (AppCompat) 
activity_crime 


Empty Activity 


Cancel Previous Next | Finish | 





图 7-8 ”创建 CrimeActivity 


7.3.2 两 类 fragment 


fragment 是 在 API 11 级 系统 版 本 中 引入 的 ， 当 时 Google 发 布 了 第 一 台 平 板 设备 。 可 以 说 ，UI 
设计 要 灵活 ， 就 是 为 了 平板 这 样 的 大 屏幕 设备 。 现 在 ，Google 有 两 个 版 本 的 fragment 实 现 可 供 选 
择 : 原生 版 本 和 支持 库 版 本 。 

原生 版 本 的 fragment 实 现 内 置 在 设备 系统 中 。 如 果 应 用 要 支持 各 个 系统 版 本 ， 在 不 同 设备 上 
运行 的 fragment 可 能 会 有 不 同 的 表现 。( 这 主要 是 因为 各 个 版 本 的 维护 有 差异 ， 例 如 ， 某 个 bug 在 
4.4 系 统 版 本 里 已 修正 ， 而 在 4.0 里 却 没 有 。) 支持 库 版 本 的 fragment 在 类 库 里 ， 发 布 时 ， 会 打包 在 
应 用 里 。 显 然 ， 使 用 支持 库 fragment 的 应 用 ， 无 论 在 哪 台 设 备 上 运行 ， 都 会 有 相同 的 表现 。 

CriminalIntent 应 用 选择 使 用 支持 库 中 的 fragment 实 现 。 考虑 到 fragment API 不 断 引 入 新 特性 以 
及 支持 库 不 断 更 新 的 现状 ， 这 一 选择 还 是 比较 明智 的 〈 进 一 步 解 释 ， 请 参见 7.9 节 )。 

















7.3.3 在 Android Studio 中 增加 依赖 关系 


我 们 要 使 用 的 支持 库 版 fagment 来 自 于 AppCompat 库 。Google 为 开发 者 提供 了 很 多 兼容 库 ， 
这 是 其 中 一 个 。 本 书 至 始 至 终 都 会 使 用 它 。 和 欲 进一步 了 解 这 个 库 ， 请 参见 第 13 章 。 
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要 使 用 AppCompat 支 持 库 , 项 目 必 须 将 其 列 人 依赖 关系 。 打 开 应 用 模块 下 的 build.gradle 文 件 。 
每 个 项 目 都 有 两 个 build.gradle 文 件 。 一 个 用 于 整个 项 目 ， 另 一 个 用 于 应 用 模块 。 我 们 要 编辑 的 是 
app/build.gradle 文 件 。 
代码 清单 7-1 Gradle 依 赖 设置 (app/build.gradle ) 


apply plugin: "com.android.appLication' 
android { 
} 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 


ainita “com.android.support:appcompat-v7:25.0.1' 

} 

build.gradle 待 编辑 文件 的 当前 依赖 设置 类 似 于 代码 清单 7-1。 也 就 是 说 ,项 目 依赖 于 libs 目 录 
下 的 所 有 jar 包 。Android Studio 在 创建 项 目 时 , 也 会 自动 引入 其 他 依赖 库 。AppCompat 库 很 可 能 就 
已 经 包括 在 内 了 。 

Gradle 允 许 设 置 未 复制 到 项 目 中 的 依赖 项 。 应 用 编译 时 ，Gradle 会 找到 并 下 载 依 赖 包 ， 并 将 
其 自动 导入 到 项 目 中 。 我 们 要 做 的 就 是 预先 写 好 指令 ， 剩 下 的 就 交 给 Gradle 了 。 

如 果 没 有 发 现 AppCompat 库 ， 可 使 用 Android Studio 提 供 的 工具 添加 。 选 择 File 一 Project 
Structure... 菜 单项 打开 项 目 结构 对 话 框 。 

选择 左边 的 应 用 模板 ， 然 后 在 右边 点 击 Dependencies 选 项 页 。 可 以 看 到 ， 应 用 模板 的 依赖 项 
都 列 在 这 里 了 ， 如 图 7-9 所 示 。 
































全 局 @ Project Structure 
-二 Properties Signing Flavors Build Types BDependencies 
SDK Location J ep 
Project 
| cli {include=[*jar], dir=libs} Compile 
eveloper Servi... 
网 Poe androidTestCompile(com.android.support.test.espresso:espresso-core:2.2.2", { 
Authentication mM com.android.support.constraint:constraint-layout:1.0.0-beta4 Compile 
Notifications Immjunitjunit:4.12 Test compile ~ 
Modules 
二 一 下 





图 7-9 app 依赖 项 
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AppCompat 依 赖 项 可 能 已 列 在 其 中 。 如 果 没 有 ， 单 击 + 按钮 ， 选 择 Library dependency 界 面 添 
加 新 的 依赖 项 ， 如 图 7-10 所 示 。 从 列表 中 选中 appcompat-v7 库 后 单 击 OK 按钮 确认 。 





国 口 @ Choose Library Dependency 


com.android.support:appcompat-v7:25.0.1 


Enter terms for Maven Central search, or fully-qualified coordinates (e.g. com.google.code.gson:gson:2.2.4) 





com.android.support:appcompat-v7 (com.android.support:appcompat-v7:25.0.1) 
com.hanhuy.android:scala-conversions-appcompat_2.11 (com.hanhuy.android:scala-conversions-appcompat_2.... 
com.hanhuy.android:scala-conversions-appcompat_2.10 (com.hanhuy.android:scala-conversions-appcompat_2.... 
com.squareup.assertj:assertj-android-appcompat-v7 (com.squareup.assertj:assertj-android-appcompat-v7:1.1.1) 
comjakewharton.rxbinding:rxbinding-appcompat-v7-kotlin (com.jakewharton.rxbinding:rxbinding-appcompat-... 
comjjakewharton.rxbinding:rxbinding-appcompat-v7 (com.jakewharton.rxbinding:rxbinding-appcompat-v7:1.0.0) 
com.pkware.truth-android:truth-android-appcompat-v7 (com.pkware.truth-android:truth-android-appcompat-... 


carce QL 





图 7-10 ”可 选 依赖 项 


回 到 app/build.gradle 文 件 的 编辑 窗口 ，AppCompat 依 赖 项 已 添加 完毕 ， 如 代码 清单 7-1 所 示 。 

(如 果 手 动 修改 了 app/build.gradle 文 件 ， 就 需要 同步 项 目 和 Gradle 文 件 以 更 新 修改 内 容 。 同 步 
就 是 要 求 Gradle 通 过 下 载 或 删除 依赖 项 , 基于 修改 重新 编译 。 选择 Tools 一 Android 一 Sync Project 
with Gradle Files 菜 单项 可 手动 执行 同步 。) 

代码 清单 7-1 中 ， 灰 底部 分 的 依赖 项 字符 串 使 用 了 Maven 坐 标 模式 : groupId:artifactId: 
version。( Maven 是 一 个 依赖 包 管 理工 具 ， 详 见 其 官方 网 站 https:/maven.apache.org/。) 

groupId 通 常 是 类 库 的 基础 包 名 ， 能 唯一 标识 Maven 仓 库 中 的 依赖 类 库 ， 如 上 例 中 的 
com.android.support。 

artifactId 是 包 中 的 特定 库 名 ， 我 们 指定 的 是 appcompat-v7。 

最 后 一 项 version 是 指 类 库 的 版 本 号 。CriminalIntent 应 用 依赖 于 版 本 号 为 25.0.1 的 
appcompat-v7 库 。 这 是 本 书 截 稿 时 的 最 新 版 本 。 当 然 ， 我 们 的 项 目 支持 这 之 后 的 任 一 新 版 本 。 为 
了 使 用 更 新 的 API 以 及 受益 于 bug 修 复 ， 建 议 使 用 最 新 版 本 的 支持 库 。 假 如 Android Studio 更 新 了 
新 的 支持 库 ， 就 不 要 回 退 了 ， 使 用 最 新 版 本 就 好 。 

项 目 依 赖 的 支持 库 已 设置 好 了 ， 可 以 用 了 。 在 包 浏 览 器 中 ， 找 到 并 打开 CrimeActivity.java 文 
件 。 将 CrimeActivity 的 超 类 改 为 AppCompatActivity， 如 代码 清单 7-2 所 示 。 


代码 清单 7-2 ”修改 模板 代码 ( CrimeActivity.java ) 
public class CrimeActivity extends AppCompatActivity { 
































































































































@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity crime); 


} 
进一步 完善 CrimeActivity 类 之 前 ， 我 们 先 来 为 CriminalIntent 应 用 创建 模型 层 的 Crime 类 。 
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7.3.4 ”创建 Crime 类 





在 项 目 工具 窗口 中 ， 右 键 单 击 com.bignerdranch.android.criminalintent 包 ， 选 择 New 一 Java 
Class 菜 单项 。 在 新 建 类 对 话 框 中 ， 命 名 类 为 Crime， 单 击 OK 按钮 完成 。 

在 随后 打开 的 Crime.java 中 ， 增 加 代码 清单 7-3 所 示 的 代码 。 
代码 清单 7-3 ”Crime 类 的 新 增 代码 ( Crime.java ) 


public class Crime { 





private UUID mId; 
private String mTitle; 
private Date mDate; 
private boolean mSolved; 


public Crime() { 
mId = UUID. randomUUID() ; 
mDate = new Date(); 





} 
} 


UUID 是 Android 框 架 里 的 Java 工 具 类 。 有 了 它 , 产生 唯一 ID 值 就 方便 多 了 。 在 构造 方法 里 , 调 
用 UUID .randomUUID () 产 生 一 个 随机 唯一 ID 值 。 

Android Studio 可 能 会 找到 两 个 同名 Date 类 。 使 用 Option+Retum (或 Alt+Enter ) 快捷 键 手动 
导入 类 。 在 确认 应 导入 哪个 版 本 的 Date 类 时 ， 选 择 java.utitL,Date 类 。 

使 用 默认 的 Date 构 造 方法 初始 化 Data 变 量 。 作 为 crime 的 默认 发 生 时 间 ， 设置 mnDate 变 量 值 
为 当前 日 期 。 

接 下 来 ， 为 只 读 成 员 变 量 mId 生 成 一 个 getter 方 法 ， 为 成 员 变 量 mTitle、mDate 和 mSolved 生 成 
getter 方 法 和 setter 方 法 。 碳 键 单 击 构造 方法 下 面 的 空白 处 ， 选 择 Generate… 一 Getter 菜 单项 ， 然 后 
选择 mId 变 量 。 再 选择 Generate.… 一 Getter and Setter 为 变量 mTitle、mDate 和 mSolved 生 成 getter 方 
法 和 setter 方 法 ， 如 代码 清单 7-4 所 示 。 


代码 清单 7-4 已 生成 的 getter 方 法 与 setter 方 法 ( Crime.java ) 


public class Crime { 












































private UUID mId; 
private String mTitle; 
private Date mDate; 
private boolean mSolved; 


public Crime() { 
mId = UUID. randomUUID(); 
mDate = new Date(); 


} 


public UUID getId() { 
return mId; 


} 
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public String getTitle() { 
return mTitle; 


} 


public void setTitle(String title) { 
mTitle = title; 
上 


public Date getDate() { 
return mDate; 


} 


public void setDate (Date date) { 
mDate = date; 
和 


public boolean isSolved() { 
return mSolved; 


} 


public void setSolved (boolean solved) { 
mSolved = solved; 
} 
} 


以 上 是 本 章 CriminalIntent 模 型 层 及 Crime 类 所 需 的 全 部 代码 实现 工作 。 
至 此 ， 除 了 模型 层 ， 我 们 还 创建 了 能 够 托管 支持 库 版 fragment 的 activity。 接 下 来 ， 继 续 学 习 
activity 托 管 fagment 的 具体 实现 部 分 。 














7.4 ”托管 Ulfragment 


为 托管 UI fragment，activity 必 须 : 
口 在 其 布局 中 为 fagment 的 视图 安排 位 置 ; 
口 管理 fragment 实 例 的 生命 周期 。 











7.4.1 _ fragment 的 生命 周期 


图 7-11 展 示 了 fragment 的 生命 周期 。 类 似 于 activity 的 生命 周期 ， 它 具有 停止 、 暂 停 以 及 运行 
状态 , 也 拥有 可 以 覆盖 的 方法 , 用 来 在 关键 节点 完成 一 些 任务 。 可 以 看 到 , 许多 方法 对 应 着 activity 
的 生命 周期 方法 。 

这 种 对 应 非常 重要 。 因 为 fragment 代 表 activity 工 作 ， 所 以 它 的 状态 应 该 反映 activity 的 状态 
显然 ，fragment 需 要 相对 应 的 生命 周期 方法 来 处 理 activity 的 工作 。 

fragment 生 命 周 期 与 activity 生 命 周期 的 一 个 关键 区 别 就 在 于 ，fragment 的 生命 周期 方法 由 托 
管 activity 而 不 是 操作 系统 调用 。 操 作 系统 不 关心 activity 用 来 管理 视图 的 fagment。fragment 的 使 
用 是 activity 内 部 的 事情 。 




































































= 
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onPause() 


onResume0 


(activity/fragment 


























重 返 前 台 ) 
onStop() 
onstatl 4——— (activity/fragment 
再 次 可 见 ) 
onDestroyViewl) 
创建 onActivityCreated(Bundle) 
(activity 关 闭 ) 








onAttach(Context)、onCreate(Bundle). 
onCreateView() onDestroy()、onDetach() 


(全 部 在 setContentView0 方 法 中 调用 ) 





Y 
启动 销毁 
图 7-11 ” ”fragment 的 生命 周期 图 解 
随 着 CriminalIntent 应 用 开发 的 深入 ， 你 会 看 到 更 多 的 fragment 生 命 周期 方法 。 


7.4.2 托管 的 两 种 方式 


activity 托 管 UI fragment 有 如 下 两 种 方式 : 
口 在 activity 布 局 中 添加 fragment; 
口 在 activity 代 码 中 添加 fragment。 
第 一 种 方式 就 是 使 用 布局 fragment。 这 种 方式 简单 但 不 够 灵活 。 在 activity 布 局 中 添加 
fragment， 就 等 同 于 将 fragment 及 其 视图 与 activity 的 视图 绑 定 在 一 起 ， 并 且 在 activity 的 生命 周期 
过 程 中 ， 无 法 蔡 换 fragment 视 图 。 
第 二 种 方式 比较 复杂 ， 但 也 是 唯一 可 以 动态 控制 fagment 的 方式 。 何 时 添加 fragment 以 及 随 
后 可 以 完成 何 种 具体 任务 由 你 自己 定 ; 也 可 以 移 除 fragment， 用 其 他 fragment 代 替 当 前 fragment， 
然后 重新 添加 已 移 除 的 fragment。 

而 ， 为 追求 真正 灵活 的 UI 设 计 ， 就 必须 通过 代码 的 方式 添加 fragment。CrimeActivity 托 
管 CrimeFragment 就 是 采用 的 这 种 方式 。 本 章 稍 后 会 介绍 代码 的 实现 细节 。 现 在 ， 先 来 定义 
CrimeActivity 的 布局 。 


7.4.3 ”定义 容器 视图 


虽然 已 选择 在 托管 activity 代 码 中 添加 UI fragment ， 但 还 是 要 在 activity 视 图 层级 结构 中 为 
fragment 视 图 安排 位 置 。 在 CrimeActivity 的 布局 中 , 该 位 置 就 是 如 图 7-12 所 示 的 FrameLayout。 

























































































114 第 7 章 UIfragment 与 fagment 管理 器 





FrameLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/fragment_container" 

android: layout_width="match_parent" 

android: layout_height="match_parent" 





图 7-12 ”CrimeActivity 类 的 fragment 托 管 布局 

















FrameLayout 是 服务 于 CrimeFragment 的 容器 视图 。 注 意 该 容 右 视图 是 个 通用 性 视图 , 不单 
单 用 于 CrimeFragment 类 ， 你 还 可 以 用 它 托 管 其 他 的 fragment ( 后 续 章 节 会 用 到 )。 

找到 CrimeActivity 的 布局 文件 res/layout/activity_crime.xml。 打 开 该 文件 ， 使 用 图 7-12 所 示 
的 FrameLayout 替 换 上 默认 布局 。 完 成 后 的 XML 文 件 应 如 代码 清单 7-5 所 示 。 


代码 清单 7-5 ”创建 fagment 容 需 布 局 ( activity_crime.xml ) 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/fragment container" 
android:layout width="match parent" 
android:layout height="match parent"/> 


注意 ， 当 前 的 activity_crime.xml 布 局 文件 仅 由 一 个 服务 于 单个 fragment 的 容器 视图 组 成 ， 但 
托管 activity 布 局 本 身 也 可 以 非常 复杂 。 除 自身 组 件 外 ， 托 管 activity 布 局 还 可 定义 多 个 容器 视图 。 

现在 预览 布局 文件 , 或 者 运行 CriminalIntent 应 用 验证 实现 代码 。 不过，CrimeActivity 还 没 
有 托管 任何 fragment， 因 此 只 能 看 到 一 个 空 的 FrameLayout， 如 图 7-13 所 示 。( 如 果 预 览 窗口 无 法 
正确 泻 染 视 图 , 或 者 有 错误 发 生 , 请 选择 Build 一 Rebuild Project 菜 单项 重建 项 目 。 如 果 仍 有 问题 ， 
可 尝试 在 模拟 器 或 设备 上 运行 应 用 。 预 览 工具 偶尔 会 有 点 小 问题 。) 


WA 7:00 
Criminalintent 






















































































图 7-13 ”一 个 空 的 FrameLayout 
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稍 后 , 我 们 会 编写 代码 , 将 fagment 的 视图 放置 到 FrameLayout 中 。 不 过 , 首先 要 有 一 个 fragment。 
( 按 Android Studio 当 前 对 activity 的 配置 ， 应 用 顶部 的 工具 栏 默认 就 有 。 如 何 定制 工具 栏 ， 请 
阅读 第 13 章 。) 


























7.5 创建 Ulfragment 


创建 UI fragment 的 步 又 与 创建 activity 的 步骤 相同 : 
口 定义 用 户 界 面 布局 文件 ; 

口 创建 fragment 类 并 设置 其 视图 为 定义 的 布局 ; 

口 编写 代码 以 实例 化 组 件 。 

















7.5.1 定义 CrimeFragment 的 布局 


CrimeFragment 视 图 用 来 显示 包含 在 Crime 类 实例 中 的 信息 。 
首先 ， 打 开 res/values/strings.xml， 添 加 需要 的 字符 串 资源 ， 如 代码 清单 7-6 所 示 。 


代码 清单 7-6 ”添加 字符 串 资源 (res/values/strings.xml ) 


<resources> 
<string name="app name">CriminalIntent</string> 
<string name="crime title hint">Enter a title for the crime.</string> 
<string name="crime title label">Title</string> 
<string name="crime details label ">Details</string> 
<string name="crime_solved label ">Solved</string> 

</resources> 


然后 是 定义 用 户 界面 。CrimeFragment 的 视图 布局 包含 一 个 垂直 LinearLayout 组 件 ， 这 个 
组 件 又 含有 5 个 子 组 件 : 两 个 TextView 组 件 、 一 个 EditText 组 件 、 一 个 Button 组 件 和 一 个 
CheckBox 组 件 。 

要 创建 布局 文件 , 在 项 目 工具 窗口 中 , 右键 单 击 res/layout 文 件 夹 , 选择 New 一 Layoutresource 
file 菜 单项 。 命 名 布局 文件 为 fragment_crime.xml。 输 入 LinearLayout 作 为 根 元 素 节点 后 ， 单 击 
OK 按钮 完成 创建 。 

新 建文 件 打开 后 ， 查 看 XML， 会 发 现 向 导 已 经 添加 了 LinearLayout。 手 动 添 加 其 余 组 件 ， 
结果 如 代码 清单 7-7 所 示 。 


代码 清单 7-7 fragment 视 图 的 布局 文件 ( fragment crime.xml ) 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout_ margin="16dp" 
android:orientation="vertical"> 




















T 





<TextView 
style="?android:1listSeparatorTextViewStyle" 
android:layout width="match_parent" 
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android 
android 


<EditText 
android 
android 
android 
android 


<TextView 
style=" 
android 
android 
android 


<Button 


android: 
android: 
android: 


<CheckBox 


android: 
android: 
android: 


android 


</LinearLayout> 


切换 至 Design 视 


:layout height="wrap_content" 
:text="@string/crime_ title label"/> 


:id="@+id/crime title" 

:layout width="match _ parent" 
:layout_ height="wrap_content" 
:hint="@string/crime title hint"/> 


?android:listSeparatorTextViewStyle" 
:layout width="match_parent" 
:layout_height="wrap_content" 
:text="@string/crime_ details label"/> 


id="@+id/crime_date" 
layout width="match_parent" 
layout_height="wrap_content"/> 


id="@+id/crime_solved" 

layout width="match _ parent" 

layout_ height="wrap_content" 
:text="@string/crime solved label"/> 





图 ， 预 览 已 完成 的 CrimeFragment 布 局 。 
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图 7-14 预览 CrimeFragment 布 局 
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( 如 代码 清单 7-7 所 示 , fragment_crime.xml 布 局 文件 里 出 现 了 新 语法 : style="? android:List- 
SeparatorTextViewStyte"。 现 在 不 理解 没关系 ， 学 完 9.3.3 节 ，， 你 就 会 明白 了 。 ) 





7.5.2 创建 CrimeFragment 类 














右键 单 击 com.bignerdranch.android.criminalintent 包 ， 选 择 New 一 Java Class 菜 单项 。 在 弹出 的 
新 建 类 对 话 框 中 ， 命 名 类 为 CrimeFragment， 单 击 OK 按钮 完成 类 创建 。 
修改 代码 ， 让 CrimeFragment 类 继承 Fragment 类 ， 如 代码 清单 7-8 所 示 。 





代码 清单 7-8 继承 Fragment 类 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 


} 

修改 代码 继承 Fragment 类 时 ，Android Studio 会 找到 两 个 同名 Fragment 类 : Fragment 
(android.app) 和 Fragment (android.support.v4.app) 。 前 者 是 Android 操 作 系 统 内 置 版 
Fragment， 后 者 是 支持 库 版 Fragment。 选 择 后 者 ， 如 图 7-15 所 示 。 


public class CrimeFragment extends Fragment 时 
Gb a (andr roid, p) 
© TC (a 
Ot roaniC onde it (a 
个 证 FragmentHostCallback 
全 bb FragmentManager (and 
































Tb FragmentManagerNonConfig ( 
外 证 FragmentManager (and 
3 FragmentTransacti 
TH FragmentActivity 


人 Cranmantrnntainar [and 


图 7-15 ”选择 支持 库 中 的 Fragment 类 
完成 后 的 代码 应 该 和 代码 清单 7-9 一 样 。 
代码 清单 7-9 ”导入 支持 库 版 Fragment ( CrimeFragment.java ) 


package com.bignerdranch.android.criminalintent; 











import android.support.v4.app.Fragment; 
public class CrimeFragment extends Fragment { 


} 

如 果 看 不 到 Android Studio 的 提示 框 ， 或 者 误导 和 了 android.app.Fragment 类 ， 请 先 删除 导 
入 语句 ， 使 用 Option+Return ( 或 AlttEnter ) 快捷 键 手动 重新 导 和 人 。 千 万 不 要 搞 错 ,我们 需要 的 是 支 
持 库 版 Fragment。 

1. 实现 fagment 生 命 周期 方法 

CrimeFragment 类 是 与 模型 及 视图 对 象 交互 的 控制 器 , 用 于 显示 特定 crime 的 明细 信息 , 并 在 
用 户 修改 这 些 信 息 后 立即 进行 更 新 。 
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在 GeoQuiz 应 用 中 ，activity 通 过 其 生命 周期 方法 完成 了 大 部 分 逻辑 控制 工作 。 而 在 
CriminalIntent 应 用 中 , 这 些 工作 是 由 fragment 的 生命 周期 方法 完成 的 。 fragment 的 许多 生命 周期 方 
法 对 应 着 我 们 熟知 的 Activity 方 法 ， 如 onCreate(Bundle) 方 法 。 

在 CrimeFragment.java 中 ,新 增 一 个 Crime 实 例 成 员 变量 ,实现 Fragment .onCreate (Bundle) 
方法 ， 如 代码 清单 7-10 所 示 。 

实现 覆盖 方法 时 ，Android Studio 能 够 提供 便利 。 在 定义 onCreate (Bundle) 方 法 的 过 程 中 ， 
输入 方法 名 的 第 一 个 字母 时 ，Android Studio 会 弹出 建议 方法 清单 ， 如 图 7-16 所 示 。 


public class CrimeFragment extends Fragment { 











private Crime mCrime; 


oncre 
Bo public Animation onCreateAnimation(transit, enter, nex.. Fragment 





Oo public void onCreate (savedInstanceState) {...} 
加 8 public View onCreateView(inflater, container, savedIns.. Fragment 


加 si public void onCreateContextMenu (menu，v，menuInfo) Fragment 
人 Boi public void onCreate0ptionsMenu (menu, inflater) Fragment 
B91 public void onActivityCreated (savedInstanceState) Fragment 
人 Bo public void onViewCreated (view, savedInstanceState) Fragmen 


图 7-16 ”覆盖 onCreate(BundtLe) 方 法 

按 回 车 键 选择 onCreate(Bundle) 方 法 ，Android Studio 会 自动 创建 方法 存根 。 更 新 代码 创建 
个 新 crime， 结 果 如 代码 清单 7-10 所 示 。 

代码 清单 7-10 ”和 履 六 Fragment.onCreate(Bundle) 方 法 (CrimeFragment.java) 


public class CrimeFragment extends Fragment { 
private Crime mCrime; 




















@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
mCrime = new Crime(); 


} 

以 上 实现 代码 中 ， 有 以 下 几 点 值得 一 说 。 

首先 , Fragment .onCreate(BundtLe) 是 公共 方法 , 而 Activity .onCreate(Bundle) 是 受 保 
护 方法 。Fragment.onCreate(Bundle) 方 法 及 其 他 Fragment 生 命 周 期 方法 必须 是 公共 方法 ， 
为 托管 fagment 的 activity 要 调用 它们 。 

其 次 ， 类 似 于 activity，fragment 同 样 具有 保存 及 获取 状态 的 bundle。 如 同 使 用 Activity. 
onSaveInstanceState(Bundle) 方 法 那样 , 你 也 可 以 根据 需要 窗 盖 Fragment ,onSaveInstance- 
State(Bundle) 方 法 。 

另外 , fragment 的 视图 并 没有 在 Fragment.onCreate(Bundle) 方 法 中 生成 。 虽然 我 们 在 该 方 
法 中 配置 了 fragment 实 例 ， 但 创建 和 配置 fragment 视 图 是 男 一 个 Fragment 生 命 周 期 方法 完成 的 : 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) 
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该 方法 实例 化 fragment 视 图 的 布局 ， 然 后 将 实例 化 的 View 返 回 给 托管 activity 。 
LayoutInflater 及 ViewGroup 是 实例 化 布局 的 必要 参数 。Bundle 用 来 存储 恢复 数据 ， 可 供 该 方 
法 从 保存 状态 下 重建 视图 。 

在 CrimeFragment.java 中 ， 添 加 onCreateView(... ) 方 法 的 实现 代码 ， 从 fragment crime.xml 
布局 中 实例 化 并 返回 视图 ， 如 代码 清单 7-11 所 示 。 
代码 清单 7-11 藉 onCreateView(...) 方 法 (CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 
private Crime mCrime; 




















@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
mCrime = new Crime(); 





} 
@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container， 7 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment_crime, container, false); 
return v; 
} 


} 

在 onCreateView(...) 方 法 中 , fragment 的 视图 是 直接 通过 调用 LayoutInflater.inflate(...) 
方法 并 传人 布局 的 资源 ID 生成 的 。 第 二 个 参数 是 视图 的 父 视图 , 我 们 通常 需要 父 视图 来 正确 配置 
组 件 。 第 三 个 参数 告诉 布局 生成 器 是 否 将 生成 的 视图 添加 给 父 视图 。 这 里 ， 传 人 了 fatLse 人 参数 ， 
因为 我 们 将 以 代码 的 方式 添加 视图 。 

2. 在 fragment 中 实例 化 组 件 

现在 来 生成 fagment 中 的 EditText CheckBox 和 Button 组 件 。 它 们 也 是 在 onCreateView(...) 
方法 里 实例 化 。 

首先 处 理 EditText 组 件 。 视 图 生成 后 ,引用 并 为 它 添 加 对 应 的 监听 器 方法 ， 如 代码 清单 7-12 
所 示 。 


代码 清单 7-12 ”生成 并 使 用 EditText 组 件 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 
private Crime mCrime; 
private EditText mTitleField; 























@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment crime, container, false); 


mTitleField = (EditText)v.findViewById(R.id.crime title); 
mTitleField.addTextChangedListener(new TextWatcher() { 
@Override 
public void beforeTextChanged( 
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CharSequence s, int start, int count, int after) { 
// This space intentionally left blank 
} 


@Override 

public void onTextChanged( 
CharSequence s, int start, int before, int count) { 
mCrime.setTitle(s.toString()); 

} 


@Override 
public void afterTextChanged(Editable s) { 
// This one too 
} 
}); 


return v; 
} 


Fragment ,onCreateView(.,.) 方 法 中 的 组 件 引 用 几乎 等 同 于 Activity.onCreate(Bundle) 
方法 的 处 理 。 唯 一 的 区 别 是 ， 你 调用 了 fsiient 视 图 的 Viaww fihdViewBvid int) 方 法 。 以 前 使 
用 的 Activity.findviewById(int) 方 法 十 分 便利 ， 能 够 在 后 台 自 动 调用 View.findviewById 
(int) 方 法 ， 而 Fragment 类 没有 对 应 的 便利 方法 ， 因 此 必须 手动 调用 。 

fragment 中 监听 器 方法 的 设置 和 activity 中 完全 一 样 。 创 建 实 现 TextWatcher 监 听 器 接口 的 匿 
名 内 部 类 ， 如 代码 清单 7-12 所 示 。Textwatcher 有 三 个 方法 ， 不 过 现在 只 需 关 注 其 中 的 
onTextChanged (,,,) 方 法 。 

rT Cd , ) 方 法 中 , 调用 CharSequence (代表 用 户 输入 ) 的 toString() 方 法 。 
法 后汉 加 用 来 流 和 crineit 题 的 字符 串 。 

接 下 来 处 理 Button 组 件 ， 让 它 显 示 crime 的 发 生日 期 ， 如 代码 清单 7-13 所 示 。 
































代码 清单 7-13 ”设置 Button 文 字 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 
private Crime mCrime; 
private EditText mTitleField; 
private Button mDateButton; 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment crime, container, false); 


mDateButton = (Button) v.findViewById(R.id.crime date); 
mDateButton.setText(mCrime.getDate().toString()); 
mDateButton.setEnabled(false); 


return v; 


7.5 创建 UIfragment 121 





禁用 Button 按 钮 ， 确 保 它 不 会 响应 用 户 的 点 击 。 按 钮 应 处 于 灰色 状态 ， 这 样 用 户 一 看 就 知 
道 ， 按 钮 是 不 可 以 按 的 。 第 12 章 中 ，Button 按 钮 会 重新 启用 ， 并 人 允许 用 户 随意 选择 crime 日 期 。 

最 后 处 理 CheckBox 组 件 。 引 用 它 并 设置 监听 器 , 根据 用 户 操作 ,更 新 msotved 状 态 ， 如 代码 
清单 7-14 所 示 。 





























代码 清单 7-14 ”监听 CheckBox 的 变化 〈CrimeFragment,java ) 


public class CrimeFragment extends Fragment { 
private Crime mCrime; 
private EditText mTitleField; 
private Button mDateButton; 
private CheckBox mSolvedCheckBox; 
@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 


Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment crime, container, false); 


mSolvedCheckBox = (CheckBox)v.findViewById(R.id.crime_ solved); 
mSolvedCheckBox.setOnCheckedChangeListener(new OnCheckedChangeListener() { 

@Override 

public void onCheckedChanged(CompoundButton buttonView, 

boolean isChecked) { 
mCrime.setSolved(isChecked); 

} 

}); 


return v; 


} 
项 完 以 上 代码 ， 点 击 0nCheckedChangeListener: 


mSolvedCheckBox.setOnCheckedChangeListener(new OnCheckedChangeListener() 


然后 ， 使 用 Option+Return 或 Alt+Enter 组 合 键 添加 包 导 入 语句 。Android Studio 会 提供 两 个 选 
择 ， a roid.widget.CompoundButton。 
取决 于 你 的 Android Studio 版 本 , 代码 自动 补 全 功能 可 能 会 插入 CompoundButton.0nChecked- 
ChangeListener, 也 可 能 还 是 原来 的 0nCheckedChangeListener。 两 种 形式 都 没 问 题 。 但 为 了 
代码 统一 ， 建 议 保 持 0nCheckedChangeListener 这 种 形式 。 这 时 ， 可 以 按 Optiont+Return 或 
Alt+Enter 组 合 键 ， 然 后 选择 Add on demand static import for 'android.widget.CompoundButton'"， 如 


7-17 所 示 。 这 样 ， 代 码 就 更 新 得 和 代码 清单 7-14 一 样 了 。 


mSolvedCheckbox = (CheckBox) v.findViewById(R.id,crime_solved); 
mSoLvedCheckbox,set0OnCheckedChangeListener(new CompoundButton,0nCheckedChangeListener() { 


iy oniCheckedchanged ( Gono buttod ¢ Add on demand static import for 'android.widget.CompoundButton'’ *» 


mCrime, setSolved(isChecked); 允 Annotate class 'CompoundButton' as @Deprecated 


























图 7-17 ”添加 静态 引入 
CrimeFragment 类 的 代码 实现 部 分 完成 了 ， 但 现在 还 不 能 运行 应 用 查看 用 户 界面 和 检验 代码 。 





oo 
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这 是 因为 fagment 自 己 无 法 在 屏幕 上 显示 视图 , 怎么 办 ?把 CrimeFragment 添 加 给 CrimeActivity。 


7.6 同 FragmentManager 添加 Ulfragment 


在 Honeycomb 引入 Fragment 类 的 时 候 ， 为 协同 工作 ，Activity 类 中 相应 添加 了 
FragmentManager 类 。FragmentManager 类 负责 管理 fragment 并 将 它们 的 视图 添加 到 activity 的 视 


图 层级 结构 中 ， 如 图 7-18 所 示 。 





Activity 


FragmentManager 


回 退 栈 fragment 队列 


中 FragmentTransaction I 


图 7-18 ”FragmentManager 图 解 














FragmentManager 类 具体 管理 . 
口 fragment 队 列 ; 
口 ffagment 事 务 回 退 栈 ( 稍 后 会 学 习 )。 

在 CriminalIntent 必 用 中 ， 你 只 需要 关心 FragmentManager 管 理 的 ffagment 队 列 。 

要 以 代码 的 方式 将 fagment 添 加 给 activity， 需 要 直接 调用 activity 的 FragmentManager。 首 先 
是 获取 FragmentManager 本 身 。 在 CrimeActivity.java 中 ， 在 onCreate (Bundle) 方 法 中 添加 代码 
取得 FragmentManager， 如 代码 清单 7-15 所 示 。 

















代码 清单 7-15 ”获取 FragmentManager ( CrimeActivityjava ) 
public class CrimeActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity crime); 


FragmentManager fm = getSupportFragmentManager(); 


} 
如 果 添 完 代 码 遇 到 错误 , 记得 检查 导入 语句 , 看 是 否 已 导入 支持 库 版 本 的 FragmentManager 
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因为 使 用 了 支持 库 及 AppCompatActivity 类 , 所 以 这 里 调用 了 getSupportFragmentManager() 
方法 。 如果 不 考虑 旧版 本 的 兼容 性 问题 , 可 直接 继承 Activity 类 并 调用 getFragmentManager() 
方法 。 

















7.6.1 fragment 事务 


获取 FragmentManager 之 后 , 再 获取 一 个 fragment 交 给 它 管 理 ， 如 代码 清单 7-16 所 示 。( 现在 
只 需 对 照 添加 ， 稍 后 会 逐 行 解读 代码 。) 


代码 清单 7-16 ”添加 一 个 CrimeFragment ( CrimeActivity.java ) 
public class CrimeActivity extends AppCompatActivity { 








@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity crime); 


FragmentManager fm = getSupportFragmentManager(); 
Fragment fragment = fm.findFragmentById(R.id.fragment _ container); 


if (fragment == nuLL) { 
fragment = new CrimeFragment(); 
fm.beginTransaction() 
.add(R.id.fragment_container，fragment) 
.Commit(); 


} 
} 


以 上 代码 中 ,获取 fragment 不 难 理解 。add( . . . ) 方 法 及 其 相关 代码 才 是 重点 。 这 段 代码 创建 
并 提交 了 一 个 fragment 事 务 : 


if (fragment == null) { 
fragment = new CrimeFragment(); 
fm.beginTransaction() 
.add(R.id.fragment container, fragment) 
.Commit(); 


fragment 事 务 被 用 来 添加 、 移 除 、 附 加 、 分 离 或 替换 fragment 队 列 中 的 fragment。 这 是 使 用 
fragment 动 态 组 装 和 重新 组 装 用 户 界 面 的 关键 。FragmentManager 管 理 着 fragment 事 务 回 退 栈 。 

FragmentManager.beginTransaction() 方 法 创建 并 返回 FragmentTransaction 实 例 。 
FragmentTransaction 类 支持 流 接 口 (fluent interface ) 的 链 式 方法 调用 ， 以 此 配置 Fragment- 
Transaction 再 返回 它 。 因 此 ,以 上 灰 底 代码 可 解读 为 :“ 创 建 一 个 新 的 fragment 事 务 ， 执 行 一 个 
fragment 添 加 操作 ， 然 后 提交 该 事务 。 

add(.. . ) 方 法 是 整个 事务 的 核心 , 它 有 两 个 参数 :容器 视图 资源 DD 和 新 创建 的 CrimeFragment。 
容器 视图 资源 ID 你 :应 该 很 熟悉 了 , 它 是 定义 在 activity_crime.xml 中 的 FrameLayout 组 件 的 资源 ID。 
容器 视图 资源 ID 的 作用 有 
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口 告诉 FragmentManager，fragment 视 图 应 该 出 现在 activity 视 图 的 什么 位 置 ; 
口 唯一 标识 FragmentManager 队 列 中 的 ffagment。 
如 需 从 FragmentManager 中 获取 CrimeFragment ， 使 用 容器 视图 资源 ID 就 行 了 : 


FragmentManager fm = getSupportFragmentManager(); 
Fragment fragment = fm.findFragmentById(R.id.fragment container); 








if (fragment == nuLL) { 
fragment = new CrimeFragment () 
fm.beginTransaction() 
.add(R.id.fragment container, fragment) 
.Ccommit(); 
} 

FragmentManager 使 用 FrameLayout 组 件 的 资源 ID 识别 CrimeFragment ， 这 看 上 去 可 能 有 点 
怪 。 但 实际 上 , 使 用 容器 视图 资源 有 DD 识别 UI fragment 就 是 FragmentManager 的 一 种 内 部 实现 机 制 。 
如 果 要 向 activity 添 加 多 个 fragment， 通 常 就 需要 分 别 为 每 个 fagment 创 建 具 有 不 同 ID 的 不 同 容器 。 

现在 从 头 至 尾 对 代码 清单 7-16 中 的 新 增 代 码 作 一 个 总 结 。 

首先 ， 使 用 R.id.fragment_container 的 容器 视图 资源 ID ， 向 FragmentManager 请 求 并 获 
取 人 fragment。 如 果 要 获取 的 fragment 在 队列 中 ，FragmentManager 就 直接 返回 它 。 

为 什么 要 获取 的 fragment 可 能 有 了 呢 ? 前 面 说 过 , 设备 旋转 或 回收 内 存 时 ，Android 系 统 会 销 
毁 CrimeActivity， 而 后 重建 时 ， 会 调用 CrimeActivity.onCreate(BundtLe) 方 法 。activity 被 
销毁 时 ， 它 的 FragmentManager 会 将 fragment 队 列 保 存 下 来 。 这 样 ，activity 重 建 时 ， 新 的 
FragmentManager 会 首先 获取 保存 的 队列 ， 然 后 重建 fagment 队 列 ， 从 而 恢复 到 原来 的 状态 。 

当然 , 如 果 指 定 容器 视图 资源 了 D 的 fragment 不 存在 , 则 fragment 变 量 为 空 值 。 这 时 应 该 新 建 
CrimeFragment ， 并 启动 一 个 新 的 ffagment 事 务 ， 将 新 建 fagment 添 加 到 队列 中 。 

CrimeActivity 目 前 托管 着 CrimeFragment。 运 行 CriminalIntent 必 用 验证 这 一 点 ， 应 该 可 以 
看 到 定义 在 fragment_crime.xml 中 的 视图 ， 如 图 7-19 所 示 。 


BA RA 
Criminallntent 


TITLE 



























































Enter a title for the crime. 





口 soved 








图 7-19 CrimeActivity 托 管 的 CrimeFragment 视 图 
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7.6.2 FragmentManager 与 fragment 生命 周期 


掌握 了 FragmentManager 的 基本 使 用 后 ， 有 必要 重新 审视 fragment 的 生命 周期 ， 如 图 7-20 
所 示 。 











onPause(} 


onResumel 
0 一 (activity/fragment 
重 返 前 台 ) 
onstop0 





onStart0 <- (activityfragment 
再 次 可 见 ) 























onDestroyView!) 
创建 onAvtivityCreated(Bundle) 
(activity 关 闭 ) 
~、 
onAttach(Context)、onCreate(Bundle).、 
onCreateView() (全 部 在 setContentView0 onDestroyO、onDetach() 
方法 中 调用 ) 
+ 
启动 销毁 





图 7-20 再 探 fagment 生 命 周 期 


activity 的 FragmentManager 负 责 调 用 队列 中 fragment 的 生命 周期 方法 。 添 加 fragment 供 
FragmentManager 管 理 时 , onAttach (Context)、onCreate (Bundle) 和 onCreateView(...) 方 法 
会 被 调用 。 

托管 activity 的 onCreate(Bundle) 方 法 执行 后 ，onActivityCreated (Bundle) 方 法 也 会 被 
调用 。 因 为 是 在 CrimeActivity.onCreate (Bundle) 方 法 中 添加 CrimeFragment，, 所 以 fragment 
被 添加 后 ， 该 方法 会 被 调用 。 

在 activity 处 于 运行 状态 时 ， 添 加 fragment 会 发 生 什 么 呢 ? 这 种 情况 下 ，FragmentManager 立 
即 驱 赶 fragment， 调 用 一 系列 必要 的 生命 周期 方法 ， 快 速 跟 上 activity 的 步伐 〈 与 activity 的 最 新 状 
态 保持 同步 )。 例 如 ， 向 处 于 运行 状态 的 activity 中 添加 fragment 时 ， 以 下 fragment 生 命 周期 方法 会 
被 依次 调用 : onAttach(Context) .onCreate(BundtLe) .onCreateView(.,,) .onActivityCreated 
(Bundle)、onStart() 以 及 onResume()。 

一 旦 追 上 , 托管 activity 的 FragmentManager 就 会 边 接 收 操作 系统 的 调用 指令 , 边 调用 其 他 生 
命 周 期 方法 ， 让 fragment 与 activity 的 状态 取得 一 致 。 
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7.7 采用 fragment 的 应 用 架构 





设计 应 用 时 ， 正 确 使 用 fragment 非 常 重要 。 然 而 ， 
用 组 件 ， 只 要 可 能 ， 就 直接 使 用 fragment。 这 实际 是 在 滥用 fragment。 
fragment 是 用 来 封装 关键 组 件 以 方便 复 用 。 这 里 所 说 的 关键 组 件 ， 是 针对 应 用 的 整个 屏幕 来 
讲 的 。 如 果 单 屏 就 使 用 大 量 fragment， 不 仅 应 用 代码 充斥 着 fragment 事 务 处 理 ， 模 块 的 职责 分 工 
































许多 开发 者 学 习 了 fragment 之 后 ， 为 了 复 











也 会 不 清晰 ,如果 有 很 多 零碎 小 组 件 要 复 用 ,比较 好 的 架构 设计 是 使 用 定制 视图 ( 使 用 View 子 类 )。 

















总 之 ,一定 要 合理 使 用 fragment。 实 践 证 明 ， 应 用 单 屏 最 多 使 用 2 ~ 3 个 fragment， 如 图 7-21 





所 示 。 





图 7-21 ” 少 就 是 多 的 哲学 


使 用 fragment 的 理由 
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自 本 章 开始 ， 无 论 应 用 多 么 简单 ， 你 都 会 看 到 fragment 的 身影 。 这 貌似 有 点 激进 ， 要 知道 ， 

















做 的 话 ， 代 码 量 会 更 少 。 


然而 ， 我 们 认为 ， 这 是 实际 开发 中 比较 实 月 


有 人 可 能 觉得 ， 在 应 用 开发 初期 暂 不 使 有 











后 续 章 节 的 很 多 应 用 不 用 fragment 也 行 。 用 户 界面 可 以 只 使 月 














有 activity 来 创建 和 管理 ， 而 且 ， 这 样 





有 的 模式 ， 建 议 尽早 适 应 。 
有 fragment， 等 到 需要 时 再 添加 它 会 好 一 些 。 极 限 编 
程 方 法 论 中 有 个 YAGNI 原 则 。YAGNI ( You Arenm’t Gonna Need It ) 的 意思 是 “你 不 会 需要 它 ”， 


























该 原则 鼓 励 大 家 不 要 去 实现 那些 有 可 能 需要 的 东西 ,为 什么 呢 ” 因 为 你 不 会 需要 它 。 因 此 ,YAGNI 
原则 等 于 在 说 ， 可 用 可 不 用 ， 那 就 不 要 用 fragment 本 。 
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不 笠 的 是 ， 经 验 表 明 ， 后 期 添加 fragment 就 如 同 掉 泥 坑 。 从 activity 管 理 用 户 界面 调整 到 由 
activity 托 管 UI fragment 虽 然 不 难 , 但 会 有 一 大 堆 恼 人 的 问题 等 着 你 。 你 也 可 能 会 想 让 部 分 用 户 界 
面 仍 由 activity 管 理 , 部 分 用 户 界面 改 用 fragment 管 理 , 这 只 会 让 事情 更 糟 。 哪 些 不 改 ， 哪些 要 改 ， 
光 理 清 这 些 就 够 你 头痛 的 了 。 显 然 ， 从 一 开始 就 使 用 fragment 更 容易 ， 既 不 用 返工 ， 也 不 会 出 现 
晶 不 清 哪个 部 分 使 用 了 哪 种 视图 控制 风格 这 种 事 了 。 

因而 ,对 于 fragment, 我 们 坚持 AUF ( Always Use Fragments ) 原则 ， 即 “总 是 使 用 fragment”。 
不 值得 为 使 用 fragment 还 是 activity 伤 脑筋 ， 相 信 我们 ， 总 是 使 用 fragment!1 


7.8 深入 学 习 : fragment 与 支持 库 


在 本 章 中 ， 为 使 用 支持 库 版 fagment，CriminalIntent 项 目 引 入 了 AppCompat 库 。 然 而 ， 这 个 
库 自 身 并 没有 实现 fragment 功 能 ， 它 依赖 support-v4 库 。 所 以 ， 真 正 实 现 fragment 功 能 的 是 
Support-v4 库 。 

Google 为 开发 者 提供 的 支持 库 有 很 多 ， 如 supportrv4 、appcompatrv7 和 recyclerview-v7 等 。 早 
期 ， 支 持 库 只 有 一 个 ， 说 支持 库 就 是 指 support-v4 库 。 后 来 ， 各 种 功能 越 加 越 多 ， 这 个 库 不 断 膨 
胀 ， 最 终 不 可 避免 地 成 了 一 个 大 杂烩 。 于 是 ，Google 决 定 另 起 炉灶 ， 然 后 就 有 了 上 面 提 到 的 各 种 
支持 库 。 

前 面 说 过 ，support-v4 库 支持 实现 fragment 功 能 。 你 可 以 在 该 库 中 找到 android.support. 
v4.app.Fragment 的 源码 。support-v4 库 里 也 有 一 个 Activity 子 类 : FragmentActivity。 要 使 
用 支持 库 版 fagment， 应 用 的 activity 必 须 继承 FragmentActivity。 

如 图 7-22 所 示 ，AppCompatActivity 是 FragmentActivity 的 子 类 。CriminalIntent 项 目 引 入 
了 AppCompat 库 ， 所 以 应 用 能 使 用 支持 库 版 fagment。 如 果 只 想 用 support-v4 库 也 可 以 ， 只 要 在 项 
目 里 引入 它 ， 然 后 把 各 个 activity 的 父 类 从 AppCompatActivity 改 为 FragmentActivity 就 行 了 。 
改 来 改 去 好 麻烦 。 没 关系 ， 和 本 书 一 样 ， 就 用 AppCompat 支 持 库 吧 。 如 今 ， 大 多 数 开发 人 员 都 在 
用 它 。 第 13 章 还 会 介绍 AppCompat 支 持 库 的 其 他 功能 ， 敬 请 期 待 。 


























‘tt 




















































































































Activity 














图 7-22 ”AppCompatActivity 继 承 树 
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7.9 深入 学 习 : 为 什么 优先 使 用 支持 库 版 fagment 


本 书 坚 持 使 用 支持 库 版 fragment。 这 似乎 不 是 一 条 寻常 路 .毕竟 ,Google 提 供 支 持 库 版 fagment 
的 本 意 是 方便 在 不 支持 该 API 的 旧版 本 上 使 用 fragment。 要 知道 ， 大 多 数 开 发 人 员 如 今 都 只 用 操 
作 系 统 内 置 版 fagment。 

坚持 的 理由 是 什么 ? 我 们 认为 ， 支 持 库 版 fagment 使 用 最 方便 。 任 何 时 候 ， 只 要 想 升 级 支持 
库 版 fagment 的 话 ， 只 需要 下 载 升级 包 ， 重 新 编译 发 布 一 个 新 版 本 应 用 就 行 了 。Google 每 年 会 多 
次 更 新 支持 库 ,， 并 借 此 引入 新 特性 、 修 复 bug。 要 享受 这 些 好 处 ， 升 级 应 用 的 支持 库 版 本 就 行 了 。 

举 个 例子 ，Google 自 Android 4.2 开 始 支持 fragment 众 套 使 用 ( 在 fragment 中 托管 fagment )。 如 
果 基 于 操作 系统 内 置 版 fagment 开 发 ， 并 且 面 向 Android 4.0 及 以 上 版 本 的 设备 ， 那 么 应 用 就 无 法 
使 用 这 个 新 特性 了 。 假 如 用 了 支持 库 版 fagment， 就 能 轻松 升级 应 用 的 支持 库 版 本 , 享用 fragment 
柑 套 新 特性 (设备 内 存 要 足够 大 哦 )。 
此 外 ， 使 用 支持 库 版 fragment 没 有 显著 的 缺点 。 就 功能 实现 来 讲 ， 它 和 操作 系统 内 置 版 本 没 
什么 不 同 。 非 要 挑 毛病 的 话 ， 那 就 是 导入 支持 库 包 会 占用 额外 空间 。 不 过 考虑 到 上 述 诸多 优点 ， 
牺牲 不 到 1M 的 空间 并 不 算 什么 。 

本 书 强 调 实 用 ， 多 年 的 开发 实践 表明 ，Android 支 持 库 就 是 无 网 之 王 。 

当然 ， 如 果 你 有 自己 的 想法 ， 非 要 用 操作 系统 内 置 版 fragment， 也 可 以 。 

要 使 用 标准 库 里 的 fragment， 需 对 项 目 做 以 下 改动 。 
口 弃 用 FragmentActivity 类 ， 改 用 标准 库 中 的 Activity 类 (android.app.Activity )。 
它 默认 支持 在 API 11 级 或 更 高 版 本 系统 中 使 用 fragment。 
口 弃 用 android.support.v4.app.Fragment 类 ， 改 用 android.app.Fragment 类 。 
口 弃 用 getSupportFragmentManager() 方 法 ， 改 用 getFragmentManager() 方法 获取 

FragmentManager。 





















































































































































第 8 章 
使 用 RecyclerView 显 示 
列表 








当前 ，CriminalIntent 应 用 的 模型 层 仅 包含 一 个 Crime 实 例 。 本 章 ， 我 们 将 更 新 CriminalIntent 
应 用 以 支持 显示 crime 列 表 。 列 表 会 显示 每 个 Crime 实 例 的 标题 及 其 发 生日 期 ， 如 图 8-1 所 示 。 


A700 
Criminallntent 


Crime #0 
Thu Nov 17 10:06:08 EST 2016 








Crime #1 
Thu Nov 17 10:06:08 EST 2016 


Crime #2 
Thu Nov 17 10:06:08 EST 2016 


Crime #3 
Thu Nov 17 10:06:08 EST 2016 


Crime #4 
Thu Nov 17 10:06:08 EST 2016 


Crime #5 
Thu Nov 17 10:06:08 EST 2016 


Crime #6 
Thu Nov 17 10:06:08 EST 2016 


Crime #7 
Thu Nov 17 10:06:08 EST 2016 


Crime #8 
Thu Nov 17 10:06:08 EST 2016 


Crime #9 
Thu Nov 17 10:06:08 EST 2016 


Crime #10 
Thu Nov 17 10:06:08 EST 2016 


图 8-1 ”crime 列 表 


8-2 是 CriminalIntent 应 用 在 本 章 的 整体 规划 图 。 

应 用 模型 层 将 新 增 一 个 CrimeLab 对 象 ， 该 对 象 是 一 个 数据 集中 存储 池 ， 用 来 存储 Crime 对 象 。 
显示 crime 列 表 需 在 应 用 控制 句 层 新 增 一 个 activity 和 一 个 fragment: CrimeListActivity 和 
CrimeListFragment。 
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模型 
ArrayList mCrimes 
控制 器 | 
mCrimes 
CrimeListFragment getActivity() 
CrimeListActivity 
和 


图 8-2 ”CriminalIntent 应 用 对 象 图 


(图 8-2 中 怎么 没有 CrimeActivity 和 CrimeFragment 呢 ? 它们 是 与 明细 视图 相关 的 类 , 所 以 
这 里 没有 显示 。 在 第 10 章 中 ， 我 们 将 学 习 如 何 关 联 CriminalIntent 应 用 的 列表 视图 和 明细 视图 。) 

在 图 8-2 中 ， 也 可 以 看 到 与 CrimeListActivity 和 CrimeListFragment 关 联 的 视图 对 象 。 
activity 视 图 由 包含 fragment 的 FrameLayout 组 成 。fragment 视 图 由 一 个 RecyclerView 组 成 。 稍 后 
会 介绍 RecyclerView 类 。 


8.1 升级 Criminallntent 应 用 的 模型 层 
首先 ， 我 们 来 升级 应 用 的 模型 层 ， 从 容纳 单个 Crime 对 象 变 为 可 容纳 一 组 Crime 对 象 。 


单 例 与 数据 集中 存储 


crime 数 组 对 象 将 存储 在 一 个 单 合 里 。 单 合 是 特殊 的 Java 类 , 在 创建 实例 时 ,一 个 单 例 类 仅 允 
许 创建 一 个 实例 。 

应 用 能 在 内 存 里 活 多 和 久 , 单 例 就 能 活 多 久 。 因 此 将 对 象 列表 保存 在 单 例 里 的 话 ， 就 能 随时 获 
取 crime 数 据 ， 不 管 activity 和 fragment 的 生命 周期 怎么 变化 。 使 用 单 例 还 要 注意 一 点 : Android 从 
内 存 里 清除 应 用 时 ， 单 例 对 象 也 会 随 之 消失 。 虽 然 CrimeLab 单 例 不 是 数据 持久 保存 的 好 方案 ， 
但 它 确实 能 保证 仅 拥 有 一 份 crime 数 据 ， 并 且 能 让 控制 器 层 类 间 的 数据 传递 更 容易 。( 第 14 章 会 介 
绍 如何 持 久 化 保存 数据 。) 

(要 进一步 了 解 单 例 类 ， 请 参见 8.7 节 。) 
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要 创建 单 例 ， 需 创建 一 个 带 有 私有 构造 方法 及 get () 方 法 的 类 。 如 果实 例 已 在 在 ，get ( ) 方 
法 就 直接 返回 它 ; 如 果实 例 还 不 存在 ，get ( ) 方 法 就 会 调用 构造 方法 创建 它 。 

右键 单 击 com.bignerdranch.android.criminalintent 类 包 ， 选 择 New 一 Java Class 菜 单项 。 在 随后 
出 现 的 对 话 框 中 ， 命 名 类 为 CrimeLab ， 然 后 单 击 OK 按钮 。 

在 打开 的 CrimeLab.java 文 件 中 , 编码 实现 CrimeLab 类 为 带 有 私有 构造 方法 和 get () 方 法 的 单 
例 ， 如 代码 清单 8-1 所 示 。 


代码 清单 8-1 创建 单 例 ( CrimeLab.java ) 


public class CrimeLab { 
private static CrimeLab sCrimeLab; 

















public static CrimeLab get(Context context) { 
if (sCrimeLab == null) { 
sCrimeLab = new CrimeLab (context); 


return sCrimeLab; 


. 


private CrimeLab(Context context) { 


} 
} 


以 上 代码 有 几 点 值得 一 说 。 

首先 ， 注意 sCrimeLab 变 量 的 s 前 级 。 这 是 Android 开 发 的 命名 约定 ,一 看 到 此 前 级 ， 我 们 就 
知道 sCrimeLab 是 一 个 静态 变量 。 

其 次 ， 再 来 看 CrimeLab 的 私有 构造 方法 。 显 然 ， 其 他 类 无 法 创建 CrimeLab 对 象 ， 除 非 调用 
get () 方 法 。 

最 后 ， 在 get () 方 法 里 ， 我 们 传人 的 是 Context 对 象 ( 第 14 章 会 用 到 )。 

下 面 ， 我 们 往 CrimeLab 中 存储 Crime 对 象 。 在 CrimeLab 的 构造 方法 里 ， 创 建 一 个 空 List 用 
来 保存 Crime 对 象 。 此 外 ， 再 添加 两 个 方法 : getCrimes() 和 getCrime(UUID) 。 前 者 返回 数组 
列表 ， 后 者 返回 带 指定 ID 的 Crime 对 象 ， 如 代码 清单 8-2 所 示 。 


代码 清单 8-2 创建 可 容纳 Crime 对 象 的 List (CrimeLab.java ) 


public class CrimeLab { 
private static CrimeLab sCrimeLab; 














private List<Crime> mCrimes; 
public static CrimeLab get(Context context) { 


} 


private CrimeLab(Context context) { 
mCrimes = new ArrayList<>(); 
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} 


public List<Crime> getCrimes() { 
return mCrimes; 


} 


public Crime getCrime(UUID id) { 
for (Crime crime : mCrimes) { 
if (crime.getId().equals(id)) { 
return crime; 
} 
} 


return null; 


} 








List<E> 是 一 个 泛 型 类 ， 支 持 存 放 特 定数 据 类 型 的 有 序列 表 对 象 ， 拥 有 获取 、 新 增 和 删除 列 
表 元 素 的 方法 。 常 见 的 List 实 现 有 ArrayList (使 用 常规 Java 数 组 存储 列表 元 素 )。 
既然 mCrimes 含 有 ArrayList， 而 ArrayList 也 是 一 个 List， 那 么 对 于 mCrimes 来 说 ， 


























ArrayList 和 List 都 是 有 效 的 类 型 。 有 鉴于 此 ， 推 荐 在 声明 变量 的 时 候 使 用 List 接 口 类 型 。 这 











样 ， 若 有 需要 ， 还 可 以 方便 地 使 用 其 他 List 实 现 ， 如 LinkedList。 


mCrimes 实 例 化 语句 使 用 了 Java 7 引入 的 <> 符 号 。 该 符号 告诉 编译 器 ，List 中 的 元 素 类 型 可 


以 基于 变量 声明 传人 的 抽象 参数 来 确定 。 这 里 ， 因 为 





变量 声明 语句 private List<Crime> 


mCrimes ;中 指定 了 Crime 参 数 , 所 以 编译 器 可 据 此 推测 出 ArrayList 里 可 放 和 人 人 Crime 对 象 。( Java 
7 之前， 必须 这 么 写 : mCrimes = new ArrayList<Crime>();。) 
最 后 ， 新 建 List 将 包含 用 户 自 建 的 Crime， 用 户 可 自由 存 取 它 们 。 现 在 ， 先 批量 存 人 100 个 




















毫 无 个 性 的 Crime 对 象 ， 如 代码 清单 8-3 所 示 。 





代码 清单 8-3 ”生成 100 个 crime ( CrimeLab.java ) 


private CrimeLab(Context context) { 
mCrimes = new ArrayList<>(); 
for (int i = 0; i < 100; i++) { 
Crime crime = new Crime(); 
crime.setTitle("Crime #" + i); 








crime.setSolved(i % 2 == 0); // Every other one 


mCrimes.add(crime); 


} 


这 样 ， 一 个 满载 100 个 crime 数 据 的 模型 层 诞生 了 。 


8.2 ”使 用 抽象 activity 托管 fragment 





创建 托管 CrimeListFragment 的 CrimeListActivity 类 之 前 ， 首 先 为 CrimeListActivity 


创建 视图 。 
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8.2.1 通用 型 fragment 托管 布局 


对 于 CrimeListActivity， 我 们 仍 可 以 使 用 定义 在 activity_crime.xml 文 件 中 的 布局 ( 代码 清 
单 8-4 )。 该 布局 提供 了 一 个 放置 fragment 的 FrameLayout 容 还 视 图 ， 其 中 的 fragment 可 在 activity 
中 使 用 代码 获取 。 


代码 清单 8-4 通用 的 布局 定义 文件 activity_crime.xml 
<?xml version="1.0" encoding="utf-8"?> 
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/fragment container" 
android:layout width="match parent" 
android:layout height="match parent" 
/> 
activity_crime.xml 布 局 文件 并 没有 特别 指定 fagment， 任 何 activity 托 管 fagment 的 场景 ， 都 可 
以 使 用 它 。 下 面 ， 为 了 让 该 布局 更 加 通用 ， 重 命名 它 为 activity_fragment.xml。 
在 项 目 工 具 窗 口中 ， 右 键 单 击 res/layout/activity_crime.xml 文 件 。( 注意 是 单 击 activity_crime 
xml 文 件 ， 而 不 是 fagment crime.xml。) 
在 弹出 菜单 里 ， 选 择 Refactor 一 Rename... 菜 单项 ， 将 activity_crime.xml 改 名 为 activity 
fragment.xml。 
Android Studio 应 该 自动 更 新 引用 。 如 果 看 到 CrimeActivityjava 代 码 有 错 ， 则 需要 在 Crime- 
Activity 文 件 中 手动 更 新 引用 代码 ， 如 代码 清单 8-5 所 示 。 


代码 清单 8-5 ”为 CrimeActivity 更 新 布局 文件 引用 ( CrimeActivity.java ) 


public class CrimeActivity extends AppCompatActivity { 
/** Called when the activity is first created. */ 
@Override 
protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 






































setContentView(R.Layout .activity f ragment ) ; 


FragmentManager fm = getSupportFragmentManager () ; 
Fragment fragment = fm.findFragmentById(R.id.fragment container); 


if (fragment == null) { 
fragment = new CrimeFragment(); 
fm.beginTransaction() 


.add(R.id.fragment container, fragment) 
.Commit(); 


} 


8.2.2 ”抽象 activity 类 
可 以 复 用 CrimeActivity 的 代码 来 创建 CrimeListActivity 类 。 回 顾 一 下 前 面 写 的 Crime- 
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I 


Activity 类 ， 它 的 实现 代码 简单 且 近 乎 通用 (已 复制 为 代码 清单 8-6 )。 事 实 上 ，CrimeActivity 
类 的 代码 唯一 不 通用 的 地 方 是 CrimeFragment 类 在 添加 到 FragmentManager 之 前 的 实例 化 部 分 。 


代码 清单 8-6 ”近乎 通用 的 CrimeActivity 类 (CrimeActivityjava ) 


public class CrimeActivity extends AppCompatActivity { 
/** Called when the activity is first created. */ 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity fragment ) ; 











hl 


























FragmentManager fm = getSupportFragmentManager(); 
Fragment fragment = fm.findFragmentById(R.id.fragment container); 


if (fragment == null) { 
fragment = new CrimeFragment(); 
fm.beginTransaction() 
.add(R.id.fragment container, fragment) 
.Commit(); 


} 

本 书 中 ， 几乎 每 次 新 建 activity 都 需要 这 样 一 段 代码 。 为 避免 重复 , 我 们 将 这 些 重 复 代码 封装 
为 抽象 类 。 

在 CriminalIntent 类 包 里 创建 一 个 名 为 SingleFragmentActivity 的 抽象 类 。 设 置 超 类 为 
AppCompatActivity 类 ， 如 代码 清单 8-7 所 示 。 


























代码 清单 8-7 创建 一 个 Activity 抽 象 类 ( SingleFragmentActivity.java ) 

public abstract class SingleFragmentActivity extends AppCompatActivity { 

} 

然后 ， 按 照 代 码 清单 8-8 添 加 相关 代码 。 可 以 看 到 ， 除 了 灰 底 部 分 ， 其 余 代 码 和 原来 的 
CrimeActivity 代 码 完全 一 样 。 
代码 清单 8-8 ”添加 一 个 通用 超 类 ( SingleFragmentActivity.java ) 

public abstract class SingleFragmentActivity extends AppCompatActivity { 








protected abstract Fragment createFragment(); 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.Layout.activity fragment); 


FragmentManager fm = getSupportFragmentManager(); 
Fragment fragment = fm.findFragmentById(R.id.fragment container); 


if (fragment == nuLL) { 
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fragment = createFragment(); 
fm.beginTransaction() 
.add(R.id.fragment container, fragment) 
.Commit(); 


’ 


在 以 上 代码 里 , 我 们 设置 从 activity_ fragment.xml 布 局 里 实例 化 activity 视 图 。 然 后 在 容器 中 查 
找 FragmentManager 里 的 fragment。 如 果 找 不 到 ， 就 新 建 fagment 并 将 其 添加 到 容器 中 。 

代码 清单 8-8 与 CrimeActivity 代 码 唯一 的 区 别 就 是 , 为 了 实例 化 新 的 fragment, 我 们 新 增 了 
名 为 createFragment () 的 抽象 方法 。SingteFragmentActivity 的 子 类 会 实现 该 方法 ,来 返回 
由 activity 托 管 的 fragment 实 例 。 

1. 使 用 抽象 类 

下 面 来 试 试 使 用 CrimeActivity 抽 象 类 。 首 先 将 它 的 超 类 改 为 SingleFragmentActivity。 然 
后 ， 删 除 onCreate(BundtLe) 方 法 ， 再 添加 代码 清单 8-9 所 示 的 createFragment ( ) 方 法 。 
























































代码 清单 8-9 ”清理 CrimeActivity 类 ( CrimeActivity,java ) 


public class CrimeActivity extends AppCompatActivity SingleFragmentActivity { 
/+** CaLted when the activity is first created. */ 











@Override 





@Override 
protected Fragment createFragment() { 
return new CrimeFragment(); 
} 
} 
2. 新 建 控 制 类 
现在 ， 新 建 两 个 控制 类 : CrimeListActivity 和 CrimeListFragment。 
右键 单 击 com.bignerdranch.android.criminalintent 包 ， 选 择 New 一 Java Class 菜 单项， 在 弹出 对 
话 框 中 ， 命 名 类 为 CrimeListActivity。 
修改 CrimeListActivity 类 的 超 类 为 SingleFragmentActivity 类 , 并 实现 createFragment() 
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方法 ， 如 代码 清单 8-10 所 示 。 


代码 清单 8-10 ”实现 CrimeListActivity ( CrimeListActivityjava ) 
public class CrimeListActivity extends SingleFragmentActivity { 
@Override 
protected Fragment createFragment() { 
return new CrimeListFragment(); 


} 
} 


如 果 新 建 类 时 工具 默认 加 入 了 其 他 方法 ， 如 onCreate， 请 手动 删除 。 让 SingleFragment- 
Activity 做 它 自己 的 工作 ,保持 CrimeListActivity 类 尽量 简单 。 

接 下 来 是 创建 CrimeListFragment 类 。 

再 次 右键 单 击 com.bignerdranch.android.criminalintent 包 ， 选 择 New 一 Java Class 菜 单项 ,在 弹 
出 对 话 框 中 ,命名 类 为 CrimeListFragment， 如 代码 清单 8-11 所 示 。 









































代码 清单 8-11 实现 CrimeListFragment ( CrimeListFragment.java ) 


public class CrimeListFragment extends Fragment { 
// Nothing yet 


} 


如 代码 清单 8-11 所 示 ，CrimeListFragment 类 现在 是 个 空 结构 。 稍 后 再 来 处 理 它 。 

随 着 后 续 章 节 的 深入 学 习 ， 相信 你 会 发 现 , 使 用 SingteFragmentActivity 抽 象 类 可 大 大 减 
少 代码 输入 量 ， 节 约 开发 时 间 。 现 在 ，activity 代 码 看 起 来 很 简洁 。 

3. 在 配置 文件 中 声明 CrimeListActivity 

CrimeListActivity 创 建 完成 后 ， 记 得 在 配置 文件 中 声明 它 。 另 外 ，CriminalIntent 应 用 启动 
后 ， 用 户 看 到 的 主 界面 应 该 是 crime 列 表 ， 因 此 还 要 配置 CrimeListActivity 为 launcher activity。 

如 代码 清单 8-12 所 示 ， 在 manifest 配 置 文件 中 ， 首 先 声 明 CrimeListActivity， 然 后 删除 
CrimeActivity 的 launcher activity 配 置 ， 改 配 CrimeListActivity 为 ljauncher activity。 







































































代码 清单 8-12 ”声明 CrimeListActivity 为 jauncher activity ( AndroidManifest.xml ) 


<appLication 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:theme="@style/AppTheme" > 
<activity android:name=".CrimeListActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category .LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".CrimeActivity"> 
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</activity> 


</application> 

















现在 ，CrimeListActivity 是 launcher activity。 运 行 CriminalIntent 应 用 ， 会 看 到 CrimeList- 
Activity 的 FrameLayout 托 管 了 一 个 无 内 容 的 CrimeListFragment， 如 图 8-3 所 示 。 


WAR 7:00 
Criminalintent 


图 8-3 ”没有 内 容 的 CrimeListActivity 用 户 界面 





8.3 RecyclerView、 ViewHolder 和 Adapter 


我 们 需要 CrimeListFragment 向 用 户 展示 crime 列 表 ， 这 就 要 用 到 RecyclerView 类 。 

RecyclerView 是 ViewGroup 的 子 类 ， 每 一 个 列表 项 都 是 作为 一 个 View 子 对 象 显示 的 。 这 些 
View 子 对 象 可 简单 可 复杂 ， 这 取决 于 列表 项 要 显示 些 什么 。 

首先 来 实现 简易 版 的 列表 项 显示 ， 即 每 个 列表 项 只 显示 Crime 的 标题 和 日 期 , 并且 View 对 象 
是 一 个 包含 两 个 TextView 的 LinearLayout ， 如 图 8-4 所 示 。 
在 图 8-4 中 ， 我 们 可 以 看 到 12 行 视图 View。 稍 后 ， 升 级 版 CriminalIntent 应 用 能 支持 滑动 屏幕 
查看 所 有 100 个 crime 项 。 这 是 不 是 意味 着 要 准备 100 个 视图 View 呢 ? 大 声 说 “不 ” 吧 ， 因 为 有 
RecyclerView。 
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图 8-4 


二 HH 








带 有 子 View 的 RecyclerView 





一 次 为 所 有 列表 项 创建 View 很 容易 搞 垮 应 用 。 可 以 想象 , 真实 的 应 用 要 显示 的 列表 项 远 不 止 











100 个 ， 且 要 显示 更 为 复杂 的 内 容 。 另 外 , 在 











屏幕 上 显示 单个 crime 的 话 ， 单 个 View 也 就 够 了 。 


此 ， 完 全 没 必要 同时 准备 100 个 View， 按 需 创建 视图 对 象 才 是 比较 合理 的 解决 方案 


RecyctLerVvView 就 是 这 么 做 的 。 








循环 往复 。 





它 只 创建 刚好 充满 
屏幕 切换 视图 时 ， 上 一 个 视图 会 回收 利用 。 顾 名 思 义 ， 











8.3.1 ViewHolder 和 Adapter 


RecyclerView 的 任务 仅 限 于 回收 和 定位 屏 





另外 两 个 类 的 支持 : ViewHolder 子 类 和 Adapter 子 类 





顾名思义 ，ViewHolder 只 做 一 件 事 : 





ViewHolder 


itemView 

















屏幕 的 12 个 View， 而 不 是 100 个 。 用 户 滑动 
RecyclerView 所 做 的 就 是 回收 再 利用 ， 


幕 上 的 View。 列 表 项 View 能 够 显示 数据 还 离 不 开 





。ViewHolder 要 做 的 事 很 少 , 首先 介绍 它 





容纳 View 视 图 ( 如 图 8-5 所 示 )。 


图 8-5 ”没什么 地 位 的 ViewHolder 


ViewHolder 要 做 的 事 确实 够 少 了 。 典 型 的 ViewHolder 子 类 如 代码 清单 8-13 所 示 。 
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代码 清单 8-13 ”典型 的 ViewHoLder 子 类 


public class ListRow extends RecyclerView.ViewHolder { 
public ImageView mThumbnail; 


public ListRow(View view) { 
super (view); 


mThumbnail = (ImageView) view.findViewById(R.id.thumbnail); 


} 





你 可 以 创建 ListRow 来 获取 自 定 义 的 mThumbnail 和 RecyclerView.ViewHolder 超 类 传 
入 的 itemView ， 如 代码 清单 8-14 所 示 。ViewHolder 为 itemView 而 生 : 它 引 用 着 传 给 


super (view) 的 整个 View 视 图 。 





代码 清单 8-14 ViewHolder 的 使 用 示例 


ListRow row = new ListRow(inflater.inflate(R.layout.list row, parent, false)); 
View view = row.itemView; 


ImageView thumbnailView = row.mThumbnail; 


RecyclerView 自 身 不 会 创建 视图 ， 它 创建 的 是 ViewHolder ， 而 ViewHolder 引 用 着 | 
itemView， 如 图 8-6 所 示 。 














RecyclerView 


ViewHolder ViewHolder ViewHolder ViewHolder 


itemView itemView itemView itemView 


图 8-6 ”ViewHolder 配 合 RecyclerView 使 用 












































如 果 处 理 的 是 简单 视图 ，ViewHolder 的 工作 也 会 相对 简单 。 如 果 是 复杂 视图 ，ViewHolder 
就 得 处 理 不 同 部 分 的 itemview， 以 简单 高 效 地 展示 Crime 项 。 稍 后 ， 自 定义 复杂 视图 时 ， 你 就 能 
一 宕 究竟 。 

Adapter 

图 8-6 做 了 简化 ， 实 际 上 隐藏 了 一 些 信 息 。RecyclerView 自 己 不 创建 ViewHolder。 这 个 任 
务实 际 是 由 Adapter 来 完成 的 。Adapter 是 一 个 控制 器 对 象 ， 从 模型 层 获取 数据 ， 然 后 提供 给 
RecyclerView 显 示 ， 是 沟通 的 桥梁 。 

Adapter 负 责 : 
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口 创建 必要 的 ViewHolder; 
口 绑 定 ViewHolder 至 模型 层 数 据 。 

要 创建 Adapter, 首先 要 定义 RecyclerView.Adapter 子 类 。 然后 由 它 封装 从 CrimeLab 获 取 
的 crime。 

RecyclerView 需 要 显示 视图 对 象 时 , 就 会 去 找 它 的 Adapter。 图 8-7 展 示 了 RecyclerView 可 


能 发 起 的 会 话 。 


: getltemCountl 
， 100 ， 


， onCreateViewHolder(.. .) | 

















iewHolder 


: onBindViewHolder(. .., 0) : 


: onCreateViewHolder(..,) : 


: onBindViewHolder(..., 1) : 
| Y 
图 8-7 ”生动 有 趣 的 RecyclerView-Adapter 会 话 


首先 ， 调 用 Adapter 的 getItemCount() 方 法 ，RecyclerView 询 问 数组 列表 中 包含 多 少 个 
对 象 。 

接着 ，RecyclerView 调 用 Adapter 的 onCreateViewHolder(ViewGroup，int) 方 法 创建 
ViewHolder 及 其 要 显示 的 视图 。 

最 后 , RecyclerView 会 传人 ViewHolder 及 其 位 置 , 调用 onBindViewHolder (ViewHolder,， 
int) 方 法 。Adapter 会 找到 目标 位 置 的 数据 并 将 其 绑 定 到 ViewHolder 的 视图 上 。 所 谓 绑 定 ， 就 
是 使 用 模型 数据 填充 视图 。 

整个 过 程 执 行 完毕 ，RecyclerView 就 能 在 屏幕 上 显示 crime 列 表 项 了 。 需 要 注意 的 是 ， 相 对 
于 onBindViewHolder(ViewHolder，int) 方 法 ，onCreateViewHolder(ViewGroup，int) 方 
法 的 调用 并 不 频繁 。 一旦 有 了 够 用 的 ViewHolder，RecyclerView 就 会 停止 调用 onCreate- 
ViewHolder(...) 方 法 。 随 后 ， 它 会 回收 利用 旧 的 ViewHolder 以 节约 时 间 和 内 存 。 
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8.3.2 使 用 RecycLerView 











原理 说 了 这 么 多 , 可 以 动手 使 用 RecyclerView 类 了 。RecyclerView 类 来 自 于 Google 支 持 库 。 
要 使 用 它 ， 首 先 要 添加 RecyclerView 依 赖 库 。 


单 击 File 一 Project Structure.… 菜 单项 切换 至 项 目 结构 窗口 ， 选 择 左 边 的 app 模 块 ， 然 后 单 击 
Dependencies 选 项 页 。 单 击 + 按钮 弹出 依赖 库 添加 和 窗口 。 
找到 并 选择 recyclerview-v7 支 持 库 ， 单 击 OK 按 钮 完成 依赖 库 添 加 ， 如 图 8-8 所 示 。 











Choose Library Dependency 


com.android.support:recyclerview-v7:24.2.0 


Enter terms for Maven Central search, or fully-qualified coordinates (e.g. com.google.code.gson:gson:2.2.) 
com.klinkerapps:recyclerview (com.klinkerapps:recyclerview:21.0.0) 
net.droidlabs.mvvm:recyclerview (net.droidlabs.mvvm:recyclerview:0.0.2) 
Icom.android.support:recyclerview-v7 (com.android.support:recyclerview-v7:24.2.0) 





com.github.gabrielemariotti.cards:cardslib-recyclerview (com.github.gabrielemariotti.cards:cardslib-recyclerview... 
me.tatarka.bindingcollectionadapter:bindingcollectionadapter-recyclerview (me.tatarka.bindingcollectionadapter:... 
jp.wasabeef:recyclerview-animators (jp.wasabeef:recyclerview-animators:1.2.2) 

com.twotoasters .jazzylistview:library-recyclerview (com.twotoasters .jazzylistview:library-recyclerview:1.2.1) 
com.squareup.assertj:assertj-android-recyclerview-v7 (com.squareup.assertj:assertj-android-recyclerview-v7:1.... 


Cancel | EL 





图 8-8 ”添加 RecyclerView 依 赖 库 


RecyclerView 视 图 需 在 CrimeListFragment 的 布局 文件 中 定义 。 现 在 创建 这 个 布局 文件 。 
右键 单 击 reylayout 目录 ， 选 择 New 一 Layout resource file 菜 单项 。 命 名 布局 文件 为 
fragment_crime list 后 单 击 OK 按钮 完成 。 

打开 新 建 的 fagment crime list.xml 布 局 文件 ， 修 改 根 视图 为 RecyclerView， 并 为 其 配置 ID 
生 ， 如 代码 清单 8-15 所 示 。 

















| 


| 
其) 
一 二 








代码 清单 8-15 在 布局 文件 中 添加 RecycterView 视 图 (fragment crime list.xml ) 


| 9 |: 9 tat OD i et 
android:tayout width='"match_parent" 
android:layout_ height="match_parent"> 








</LinearLayout> 

<android. support .v7 .widget .RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/crime_recycler_view" 
android:layout width="match_parent" 
android:Layout_height='"match_parent"/> 

配置 完 CrimeListFragment 的 视图 ， 接 下 来 的 任务 就 是 视图 和 fragment 的 关联 。 修 改 

CrimeListFragment 类 文件 , 使 用 布局 并 找到 布局 中 的 RecyclerView 视 图 ， 如 代码 清单 8-16 所 示 。 


代码 清单 8-16 为 CrimeListFragment 配 置 视图 ( CrimeListFragment.java ) 


public class CrimeListFragment extends Fragment { 








// Nothing yet 
private RecyclerView mCrimeRecyclerView; 


@Override 
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public View onCreateView(LayoutInfLater inflater, ViewGroup container， 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.fragment crime list, container, false); 


mCrimeRecyclerView = (RecyclerView) view 
.findViewById(R.id.crime_recycler_ view); 
mCrimeRecyclerView.setLayoutManager (new LinearLayoutManager (getActivity())); 


return view; 


} 

注意 ,没有 LayoutManager 的 支持 ,不 仅 RecyclerView 无 法 工作 ， 还 会 导致 应 用 崩 演 。 所 
以 ，RecyclerView 视 图 创建 完成 后 ， 就 立即 转交 给 了 LayoutManager 对 象 。 

RecyclerView 类 不 会 亲自 摆 放 屏幕 上 的 列表 项 。 实 际 上 ， 摆 放 的 任务 被 委托 给 了 
LayoutManager。 除 了 在 屏幕 上 摆 放 列表 项 ，LayoutManager 还 负责 定义 屏幕 滚动 行为 。 因 此 ， 
没有 LayoutManager，RecyclerView 也 就 没 法 正常 工作 。 

除了 一 些 Android 操 作 系 统 内 置 版 实现 ，LayoutManager 还 有 很 多 第 三 方 库 实现 版 本 。 我 们 
使 用 的 是 LinearLayoutManager 类 ， 它 支持 以 竖 直 列表 的 形式 展示 列表 项 。 我 们 在 本 书后 续 章 
节 中 还 会 使 用 GridLayoutManager 类 ， 以 网 格 形式 展示 列表 项 。 

运行 应 用 ， 应 该 还 是 看 不 到 内 容 ; 现在 看 到 的 是 一 个 RecyclerView 空 视图 。 要 显示 出 crime 
列表 项 ， 还 需要 完成 Adapter 和 ViewHolder 的 实现 。 
























































8.3.3 ”列表 项 视图 


如 同 CrimeFragment 的 视图 ， 显 示 在 RecyclerView 上 的 列表 项 有 自己 的 视图 层级 结构 。 创 
建 列表 项 视图 布局 和 创建 activity 或 fragment 视 图 布局 没什么 不 同 。 在 项 目 工 具 和 窗口， 右键 点 击 
res/layout 目 录 ， 选 择 New 一 Layout resource file 菜 单项 。 在 弹出 的 对 话 框 中 ,命名 布局 文件 为 
list_item_crime， 点 击 OK 按钮 完成 。 

参照 图 8-9， 更 新 布局 文件 ， 添 加 两 个 TextView 视 图 组 件 。 









































LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 

android: layout_height="wrap_content" 
android:orientation="vertical" 

android:padding="8dp" 


TextView TextView 
android:id="@+id/crime_title" android:id="@+id/crime_date" 
android: layout_width="match_parent" android: layout_width="match_parent" 
android: layout_height="wrap_content" android: layout_height="wrap_content" 


android: text=" Crime Title" android: text="Crime Date" 





图 8-9 ”更 新 列表 项 布局 
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切换 到 布局 预览 模式 , 应 该 会 看 到 一 个 长 条 形 列表 项 界面 。 稍 后 , 你 就 会 看 到 RecyclerView 
如 何 使 用 它 。 


8.3.4 实现 ViewHoLder 和 Adapter 


接 下 来 ,在 CrimeListFragment 类 中 定义 ViewHotLder 内 部 类 ， 它 会 实例 化 并 使 用 list item 
crime 布 局 ， 如 代码 清单 8-17 所 示 。 


代码 清单 8-17 定义 ViewHolder 内 部 类 ( CrimeListFragment,java ) 
public class CrimelistFragment extends Fragment { 
private class CrimeHolder extends RecyclerView.ViewHolder { 
public CrimeHoLder(LayoutInfLater inflater, ViewGroup parent) { 
super (inflater.inflate(R.layout.list item crime, parent, false)); 


} 


} 

在 CrimeHolder 的 构造 方法 里 ,我们 首先 实例 化 list_item_crime 布 局 ， 然 后 传 给 super(...) 
方法 ， 也 就 是 ViewHolder 的 构造 方法 。 基 类 ViewHolder 因 而 实际 引用 这 个 视图 。 如 果 你 ,需要 ， 
可 以 在 ViewHolder 的 ijtemView 变 量 里 找到 它 。 

定义 完 ViewHolder， 接 下 来 的 任务 是 创建 Adapter， 如 代码 清单 8-18 所 示 。 


代码 清单 8-18 ”创建 Adapter 内 部 类 ( CrimeListFragment.java ) 


public class CrimeListFragment extends Fragment { 





private class CrimeAdapter extends RecyclerView.Adapter<CrimeHolder> { 
private List<Crime> mCrimes; 
public CrimeAdapter(List<Crime> crimes) { 


mCrimes = crimes; 


} 








注意 ， 代 码 清 单 8-18 的 代码 目前 无 法 编译 通过 。 这 个 问题 稍 后 会 解决 。) 

需要 显示 新 创建 的 ViewHolder 或 让 Crime 对 象 和 已 创建 的 ViewHolder 关 联 时 ，Recycler- 
View 会 去 找 Adapter ( 调用 它 的 方法 )。RecyclerView 不 关心 也 不 了 解 具体 的 Crime 对 象 ， 这 是 
Adapter 要 做 的 事 。 

接 下 来 ,在 CrimeAdapter 中 实现 三 个 方法 ， 如 代码 清单 8-19 所 示 。( 要 自动 产生 这 些 覆 盖 方 
法 存根 ， 可 把 光标 移 到 extends 上 ， 按 Option+Return 或 Alt+Enter 组 合 键 , 然后 选择 实现 方法 ,点击 
OK 完成 。) 





























ES 
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代码 清单 8-19 ”武装 CrimeAdapter ( CrimeListFragment.java ) 
private class CrimeAdapter extends RecyclerView.Adapter<CrimeHolder> { 
@Override 
public CrimeHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
LayoutInfLater LayoutInfLater = LayoutInflater.from(getActivity()); 


return new CrimeHolder(layoutInflater, parent); 


} 


@Override 
public void onBindViewHolder(CrimeHolder holder, int position) { 


} 


@Override 
public int getItemCount() { 
return mCrimes.size(); 


} 





RecyclerView 需 要 新 的 ViewHolder 来 显示 列表 项 时 ， 会 调用 onCreateViewHolder 方 法 。 
在 这 个 方法 内 部 ， 我 们 创建 一 个 LayoutInflater， 然 后 用 它 创建 CrimeHolder。 

CrimeAdapter 必 须 覆 盖 onBindViewHoLder(...) 方 法 。 它 现在 只 是 一 个 空 方法 , 暂时 忽略 ， 
稍 后 会 完善 它 。 

搞定 了 Adapter, 最 后 要 做 的 就 是 将 它 和 RecyclerView 关 联 起 来 。 实现 一 个 设置 CrimeList- 
Fragment 用 户 界面 的 updateUI 方 法 ， 该 方法 创建 CrimeAdapter， 然 后 设置 给 RecyclerView， 
如 代码 清单 8-20 所 示 。 


代码 清单 8-20 设置 Adapter ( CrimeListFragment.java ) 


public class CrimeListFragment extends Fragment { 
































private RecyclerView mCrimeRecyclerView; 
private CrimeAdapter mAdapter; 


GOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.fragment crime list, container, false); 


mCrimeRecyclerView = (RecyclerView) view 
.findViewById(R.id,crime recycler view); 
mCrimeRecyclerView,.setLayoutManager (new LinearLayoutManager(getActivity())); 


updateUI() ; 


return view; 
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private void updateUI() { 
CrimeLab crimeLab = CrimeLab.get(getActivity()); 
List<Crime> crimes = crimeLab.getCrimes(); 


mAdapter = new CrimeAdapter(crimes); 
mCrimeRecyclerView.setAdapter (mAdapter); 


} 


在 稍 后 的 章节 中 ， 用 户 界面 的 配置 会 更 为 复杂 ， 到 时 会 向 updateUI( ) 中 添加 更 多 内 容 。 
运行 CriminalIntent 应 用 ， 深 动 查 看 RecyclerView 视 图 。 应 用 运行 界面 如 图 8-10 所 示 。 


WA 7:00 
CriminalIntent 


Crime Title 
Crime Date 











Crime Title 
Crime Date 


Crime Title 
Crime Date 


Crime Title 
Crime Date 





Crime Title 
Crime Date 


Crime Title 
Crime Date 
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Crime Title 
Crime Date 


Crime Title 
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Crime Title 
Crime Date 


Crime Title 
Crime Date 


图 8-10 多么 整齐 漂亮 的 列表 项 啊 


列表 项 看 起 来 整齐 漂亮 ,但 都 是 一 样 的 面孔 啊 ，RecyclerView 先 生 ! 左右 滑动 ， 上 下 滚动 ， 
都 是 一 个 样 。 

图 8-10 中 有 11 排 数据 ， 也 就 是 说 onCreateViewHoLder(...) 方 法 被 调用 了 11 次 。 向 下 滚动 ， 
会 有 更 多 的 CrimeHolder 被 创建 , 但 达到 一 定量 时 , RecyclerView 会 停止 创建 新 的 CrimeHolder。 
然后 它 会 回收 使 用 那些 已 滚 出 屏幕 外 的 CrimeHoLder。Recycterview 果 然 名 副 其 实 。 

稍 后 ， 我 们 会 实现 数据 绑 定 ， 到 时 ，CrimeHotLder 就 能 显示 真实 数据 了 。 


8.4 绑 定 列表 项 


所 谓 绑 定 ， 实 际 就 是 让 Java 代 码 〈Crime 里 的 模型 数据 ， 或 点 击 监听 器 ) 和 组 件 关联 起 来 。 
目前 为 止 , 书 中 的 每 一 次 视图 实例 化 都 是 绑 定 。 按 照 过 往 经 验 ， 似乎 没 必 要 把 绑 定 任务 放 人 独立 
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方法 。 不 过 ， 既 然 CrimeHotLder 会 循环 使 用 ， 分 开 处 理 视 图 创建 和 绑 定 会 有 好 处 。 

我 们 把 视图 绑 定 工作 放 入 CrimeHolder 类 里 。 绑 定之 前 ,首先 实 例 化 相关 组 件 。 由 于 这 
次 性 任务 ， 因 此 直接 放 在 构造 方法 里 处 理 ， 如 代码 清单 8-21 所 示 。 
代码 清单 8-21 在 构造 方法 中 实例 化 视图 组 件 ( CrimeListFragment.java ) 


private class CrimeHolder extends RecyclerView.ViewHolder { 

















ft 

















private TextView mTitleTextView; 
private TextView mDateTextView; 


public CrimeHolder(layoutinflater inflater, ViewGroup parent) { 
super(inflater.inflate(R.layout.list item crime, parent, false)); 


mTitleTextView = (TextView) itemView.findViewById(R.id.crime title); 
mDateTextView = (TextView) itemView.findViewById(R.id.crime date); 


} 

CrimeHoLder 还 需要 一 个 bind(Crime) 方 法 。 每 次 有 新 的 Crime 要 在 CrimeHoLder 中 显示 时 ， 
都 要 调用 它 一 次 。 现 在 实现 这 个 方法 ， 如 代码 清单 8-22 所 示 。 
代码 清单 8-22 ”实现 bind (Crime) 方 法 ( CrimeListFragment.java ) 


private class CrimeHolder extends RecyclerView.ViewHolder { 
private Crime mCrime; 


public void bind(Crime crime) { 
mCrime = crime; 
mTitleTextView,.setText(mCrime.getTitle()); 
mDateTextView.setText (mCrime.getDate().toString()); 


} 

现在 ， 只 要 取 到 一 个 Crime，CrimeHolder 就 会 刷新 显示 TextView 标 题 视图 和 TextView 日 
期 视图 。 

最 后 , 修改 CrimeAdapter 类 ,使 用 bind(Crime) 方 法 ,每 次 RecyclerView 要 求 CrimeHolder 
绑 定 对 应 的 Crime 时 ， 都 会 调用 bind(Crime) 方 法 ， 如 代码 清单 8-23 所 示 。 
代码 清单 8-23 ”调用 bind(Crime) 方 法 ( CrimeListFragment.java ) 


private class CrimeAdapter extends RecyclerView.Adapter<CrimeHolder> { 





@Override 

public void onBindViewHolder(CrimeHolder holder, int position) { 
Crime crime = mCrimes.get(position); 
holder .bind(crime); 
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再 次 运行 CriminalIntent 应 用 ，CrimeHolder 能 够 显示 不 同 的 Crime 了 ， 如 图 8-11 所 示 。 
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图 8-11 终于 有 点 样子 了 


试 试看 ， 如 果 你 一 通 猛 滑 ， 列 表 项 深 动 得 非常 流畅 。 这 要 归功 于 onBindViewHolder(...) 
方法 。 任 何 时 候 ， 只 要 有 可 能 ， 都 要 确保 这 个 方法 轻巧 、 高 效 。 


8.5 响应 点 击 


为 了 使 RecycterView 锦 上 添 花 ， 列 表 项 应 该 还 能 够 响应 用 户 的 点 击 。 在 第 10 章 中 ,用 户 点 
击 列表 项 时 ， 应 用 支持 弹出 新 界面 显示 crime 明 细 信 息 。 现 在， 先 实现 弹出 一 个 toast 消 息 。 
你 应 该 已 经 注意 到 了 ， 尽 管 RecyclerView 功 能 强大 ， 但 它 实际 上 只 专注 于 做 好 本 职工 作 。 
( 它 是 我 们 的 好 榜样 。) 因此 ， 要 自己 动手 处 理 触 摸 事 件 。 当 然 ， 如 果真 的 需要 ，RecyclerView 
也 能 帮 你 转发 触摸 事件 ; 不 过 大 多 数 时 候 没 有 必要 这 样 做 。 

很 自然 , 我 们 想到 的 常用 解决 方案 是 设置 0nClickListener 监 听 器 。 既然 列表 项 视图 都 关联 
着 ViewHolder， 就 可 以 让 ViewHolder 为 它 监听 用 户 触摸 事件 。 

我 们 通过 修改 CrimeHolder 类 来 处 理 用 户 点 击 事件 ， 如 代码 清单 8-24 所 示 。 


代码 清单 8-24 ”检测 用 户 点 击 事 件 ( CrimeListFragment.java ) 


private class CrimeHolder extends RecyclerView.ViewHolder 
impLements View.OnClickListener { 


















































public CrimeHolder(LayoutInflater inflater, ViewGroup parent) { 
super(inflater.inflate(R.layout.list item crime, parent, false)); 
itemView.setOnClickListener(this); 
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@Override 
public void onClick(View view) { 
Toast .makeText (getActivity(), 
mCrime.getTitle() + " clicked!", Toast.LENGTH_SHORT) 
.Show(); 
} 
} 


在 以 上 代码 中 ，CrimeHolder 类 实现 了 OnClickListener 接 口 ; 而 对 于 itemView 来 说 ， 
CrimeHolder 承 担 了 接收 用 户 点 击 事件 的 任务 。 
运行 CriminalIntent 应 用 。 点 击 某 个 列表 项 ， 可 看 到 弹出 的 toast 响 应 消息 。 





8.6 深入 学 习 : ListView 和 GridView 


Android 操 作 系 统 核 心 库 包含 ListView、GridView 和 Adapter 这 3 个 类 。Android 5.0 之 前 ， 创 建 
列表 项 或 网 格 项 都 应 该 优先 使 用 这 些 类 。 

这 些 类 的 API 与 RecyclerView 的 API 非 常 相似 。ListView 和 GridView 不 关心 具体 的 展示 项 ， 
只 负责 展示 项 的 滚动 。Adapter 负 责 创建 列表 项 的 所 有 视图 。 不 过 ,使 用 ListView 和 GridView 时 
不 一 定 非 要 使 用 ViewHolder 模 式 (虽然 可 以 并 且 应 该 使 用 )。 

过 去 传统 的 实现 方式 现 已 被 RecyclerView 的 实现 方式 取代 ， 因 此 不 用 再 费力 地 调整 
ListView 和 GridView 的 工作 行为 了 。 

举例 来 说 ，ListView API 不 支持 创建 水 平 滚动 的 ListView， 因 此 需要 许多 额外 的 定制 工作 。 
使 用 RecyclerView 时 ， 虽 然 创建 定制 布局 和 深 动 行为 也 需要 额外 的 工作 ,但 RecyclerView 天 和 后 
支持 拓展 ， 所 以 使 用 体验 还 不 错 。 

此 外 ，RecyclerView 还 有 支持 列表 项 动画 效果 的 优点 。 如 果 要 让 ListView 和 GridView 支 持 
添加 和 删除 列表 项 的 动画 效果 ， 实 现 起 来 既 复 杂 又 容易 出 错 ; 而 对 于 天 生 支 持 动画 特效 的 
RecyclerView 来 说 ， 对 付 这 些 任 务 简直 是 小 菜 一 碟 。 

口 吐 莲花， 不 如 直接 秀 代码 。 例 如 ， 如 果 crime 列 表 项 要 从 位 置 0 移动 到 位 置 5， 下 面 这 段 代 
码 就 可 以 做 到 。 


mRecyclerView.getAdapter().notifyItemMoved(0, 5); 




























































































8.7 深入 学 习 : 单 例 


Android 开 发 实践 中 ， 经 常会 用 到 CrimeLab 中 使 用 过 的 单 例 模 式 。 然 而 ， 单 例 若 使 用 不 当 ， 
会 导致 应 用 难以 维护 ， 因 此 它 也 常 遭 人 诉 病 。 

Android 开 发 常用 到 单 例 的 一 大 原因 是 ,它们 比 fragment 或 activity 活 得 久 。 例 如 , 在 设备 旋转 
或 是 在 fragment 和 activity 间 跳 转 的 场景 下 ， 单 例 不 会 受到 影响 ， 而 旧 的 fragment 或 activity 已 经 不 
复 存 在 了 。 
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单 例 能 方便 地 存储 和 控制 模型 对 象 。 假 设 有 一 个 比 CriminalIntent 更 为 复杂 的 应 用 , 它 的 许多 
个 activity 和 fragment 会 修改 crime 数 据 。 某 个 控制 单元 修改 了 crime 数 据 之 后 , 怎么 保证 发 送 给 其 他 
控制 单元 的 是 最 新 数据 呢 ? 如 果 CrimeLab 掌 控 数 据 对 象 , 所 有 的 修改 都 由 它 来 处 理 , 是 不 是 控制 
数据 的 一 致 性 就 容易 多 了 ? 而 且 ， 在 控制 单元 间 流 转 时 ， 你 还 可 以 给 每 个 crime 添 加 ID 标识 ， 让 
控制 单元 使 用 ID 标识 从 CrimeLab 获 取 完 整 的 crime 数 据 。 

再 来 谈 谈 单 例 的 缺点 。 举 个 例子 ， 虽 然 单 例 能 存储 数据 ， 活 得 也 比 控制 单元 长 ， 但 这 并 不 代 
表 它 能 永存 。 在 我 们 切换 至 其 他 应 用 ， 或 逢 Android 回 收 内 存 时 ， 单 例 连 同 那些 实例 变量 也 就 不 
复 存 在 了 。 结 论 很 明显 : 单 例 无 法 做 到 持久 存储 。( 将 文件 写 信 磁盘 或 是 发 送 到 Web 服 务 器 是 不 
错 的 数据 持久 化 存储 方案 。) 

单 例 还 不 利于 单元 测试 。 例 如， 如 果 应 用 代码 直接 调用 CrimeLab 对 象 的 静态 方法 , 测试 时 以 
模拟 版 本 的 CrimeLab 代 蔡 实 际 CrimeLab 实 例 就 不 太 现 实 。 实 践 中 ，Android 开 发 人 员 会 使 用 依赖 
注入 工具 解决 这 个 问题 。 这 个 工具 允许 以 单 例 模式 使 用 对 象 ， 对 象 也 可 以 按 需 替换 。 

使 用 单 例 很 方便 ， 因 而 它 很 容易 被 滥用 。 在 想 用 就 用 、 想 存 就 存 之 前 ， 和 希望 你 能 深思 熟 虑 : 
数据 究竟 用 在 哪里 ? 用 在 哪里 能 真正 解决 问题 ? 

假如 不 慎重 对 待 这 个 问题 , 很 可 能 后 来 人 在 查看 你 的 单 例 代码 时 , 就 像 打 开 了 一 个 乱糟糟 的 
废品 抽 层 ， 里 面 堆 满 了 废 电 池 、 拉 链 扣 、 旧 照片 ， 等 等 。 它 们 有 什么 存在 的 意义 ? 再 强调 一 次 : 
请 确保 有 充足 的 理由 使 用 单 例 模式 存储 你 的 共享 数据 ! 

若 使 用 得 当 ， 单 例 就 是 架构 优秀 的 Android 应 用 中 的 关键 部 件 。 

























































































8.8 挑战 练习 : RecyclerView ViewType 


请 在 RecyclerView 中 创建 两 类 列表 项 ; 一 般 性 crime， 以 及 需 警 方 介 入 的 crime。 要 完成 这 个 
挑战 ， 你 需要 用 到 RecyclerView.Adapter 的 视图 类 别 功能 (viewtype )。 在 Crime 对 象 里 ， 再 添 
加 一 个 mRequiresPolice 实 例 变 量 , 使 用 它 并 借助 getItemViewType(int) 方 法 ( developer. 
android.com/reference/android/support/v7/widget/RecyclerView.Adapter.html#getItemViewType(int) ), 
确定 该 加 载 哪个 视图 到 CrimeAdapter。 

在 onCreateViewHolder(ViewGroup，int) 方 法 里 ， 基 于 getItemViewType(int) 方 法 返 
回 的 viewType 值 , 需要 返回 不 同 的 ViewHolder。 如 果 是 一 般 性 crime， 就 仍然 使 用 原始 布局 ; 如 
果 是 需 警 方 介 入 的 crime ， 就 使 用 一 个 带 联 系 警 方 按 钮 的 新 布局 。 
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本 章 , 我 们 来 给 RecyclerView 列 表 项 添加 一 些 样 式 , 借 此 学 习 更 多 有 关 布 局 和 组 件 的 知识 。 
同时 ， 我们 还 会 重点 学 习 使 用 一 个 叫 作 ConstraintLayout 的 新 工具 。 至 本 章 结 束 时 ， 
CrimeListFragment 视 图 会 有 明显 改观 (图 9-1 )， 整 个 应 用 看 起 来 更 加 大 气 漂 亮 。 


WA 7:00 
Criminallntent 
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Crime #1 
Thu Nov 17 10:52:28 EST 2016 
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Thu Nov 17 10:52:28 EST 2016 
Crime #3 
Thu Nov 17 10:52:28 EST 2016 
Crime #4 
Lo 
Thu Nov 17 10:52:28 EST 2016 
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Thu Nov 17 10:52:28 EST 2016 
Crime #6 
2 
Thu Nov 17 10:52:28 EST 2016 
Crime #7 
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Crime #8 
Qo 


图 9-1 美观 大 气 的 CriminalIntent 应 用 


不 过 , 在 迫不及待 探索 ConstraintLayout 新 工具 之 前 ， 先 来 做 点 准备 工作 。 你 需要 把 图 9-1 
中 漂亮 的 手 钳 图 像 复 制 一 份 放 入 项 目 。 浏 览 随 书 文件 ， 找 到 并 打开 09_LayoutsAndWidgets/ 
CriminalIntent/app/src/main/res 目 录 ， 把 各 个 版 本 的 ic_solved.png 复 制 到 项 目 对 应 的 drawable 目 录 
里 。 如 果 忘 记 怎 么 做 ,请 温习 2.6 节 。 
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9.1 使 用 图 形 布局 工具 


目前 为 止 ， 布 局 都 是 以 手动 输入 XML 的 方式 创建 的 。 本 节 ， 我 们 开始 使 用 图 形 布 局 工具 。 

打开 list_item_crime.xml 布 局 文件 ， 然 后 选择 窗口 底部 的 Design 标 签 页 。 

图 形 布 局 工具 界面 的 中 间 区 域 是 布局 的 界面 预览 窗口 。 右边 紧 挨 的 是 蓝图 ( blueprint ) 视图 。 
蓝图 和 预览 视图 有 点 像 , 但 它 能 显示 各 个 组 件 视图 的 轮廓 。 预 览 让 你 看 到 视图 长 什么 样 ,， 而 从 蓝 
图 可 以 看 出 各 个 组 件 视图 的 大 小 比例 。 

图 形 布局 工具 界面 的 左边 是 组 件 面 板 视 图 ， 它 包含 了 所 有 你 可 能 用 到 的 组 件 ， 按 类 别 组 织 
( 如 图 9-2 所 示 )。 
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图 9-2 ”图 形 布局 工具 中 的 视图 
图 形 布局 工具 界面 的 左下 是 组 件 树 ， 组 件 树 表明 组 件 是 如 何在 布局 中 组 织 的 。 
图 形 布 局 工具 界面 的 右边 是 属性 视图 。 在 此 视图 中 , 你 可 以 查看 并 编辑 组 件 树 中 已 选中 的 组 
件 属性 。 



































9.2 3 引入 ConstraintLayout 


我 们 可 以 不 使 用 髓 套 布 局 , 而 使 用 ConstraintLayout 工 具 给 布局 添加 一 系列 约束 。 可 以 把 约 
束 想象 为 橡皮 筋 。 它 会 向 中 间 拉 拢 分 系 两 涉 的 东西 。 例如， 如 图 9-3 所 示 ， 从 ImageView 视 图 右边 
到 其 父 视图 右边 ( ConstraintLayout 自 己 ), 你 可 以 添加 一 个 约束 ,这 个 约束 就 向 右 拉 着 ImageView 
视图 oO 
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ImageView “一 一 >| 




















图 9-3 “右边 添加 了 约束 的 ImageView 


你 也 可 以 创建 四 个 方向 上 的 约束 ( 左 、 上 、 右 和 下 )。 如 图 9-4 所 示 ， 如 果 创 建 两 个 相反 方向 
的 约束 ， 它 们 会 均等 地 向 相反 的 方向 拉 ，ImageView 视 图 就 会 处 于 正中 间 位 置 。 











一 ImageView i 
































图 9-4 ”两 边 都 有 约束 的 ImageView 

















综 上 所 述 可 以 得 出 重点 : 想 要 在 ConstraintLayout 里 布置 视图 , 不 用 再 麻烦 地 拖 来 拖 去 了 ， 
给 它们 添加 上 约束 就 可 以 了 。 

位 置 摆 放 有 办 法 了 ， 那 如 何 控制 组 件 大 小 呢 ? 有 三 个 选择 : 让 组 件 自己 决定 (使 用 
wrap_content ); 手动 调整 ， 计 组 件 充 满 约束 布局 。 

有 了 上 述 组 件 布置 方法 ， 只 和 需 一 个 ConstraintLayout， 就 可 以 布置 多 个 布局 。 骨 套 布 局 终 
于 可 以 休息 了 。 接 下 来 ， 我 们 就 一 起 来 看 看 如 何 使 用 约束 布置 list_ item_crime 布 局 。 

















9.2.1 使 用 ConstraintLayout 


首先 转换 list_item_crime.xml 布 局 ， 改 用 ConstraintLayout。 如 图 9-5 所 示 ， 在 组 件 树 窗口 ， 
右键 单 击 根 LinearLayout ， 然 后 选择 Convert LinearLayout to ConstraintLayout 荣 单项 。 





Component Tree 
LinearLayout 














Refactor Pp 
Il Save Screenshot... 


Design | Text 
国 0: Messages Convert LinearLayout to ConstraintLayout 


图 9-5 ”转换 根 视图 为 ConstraintLayout 


四 crime_titl Linearlayout > 
pcrime da Select 
8 
和 % Cut 
计 团 Copy 
只 印 Paste Ey 
. Delete . | 
| 
Go to XML Ee 
瑟 
及 
党 











如 图 9-6 所 示 ，Android Studio 会 弹出 一 个 窗口 ， 让 你 确认 如 何 转换 。list_item_crime.xml 是 个 
简单 布局 ， 不 需要 深度 优化 。 所 以 ， 接 受 默 认 值 ， 点 击 OK 按钮 确认 。 
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Convert to ConstraintLayout 
This action will convert your layout into a ConstraintLayout, and attempt to set up constraints 


such that your layout looks the way it did before. You may need to go and adjust the constraints 
afterwards to ensure that it behaves correctly for different screen sizes， 


Flatten Layout Hierarchy 


When selected, this action will not just convert this layout to ConstraintLayout, it will 
recursively remove all other nested layouts in the hierarchy as well such that you end up 
with a single, flat layout. This is more efficient. 

Don't flatten layouts referenced from other files 
If a layout defines an android:id attribute which is looked up from java code, flattening 
out this layout may result in code that no longer compiles. Normally this action won't 


include these layouts, but if you want to get to a completely flat hierarchy, you may 


want to enable removing these and then updating the code references as necessary 
afterwards. 


Cancel [OK | 
图 9-6 “转换 默认 配置 


最 后 ， 如 图 9-7 所 示 ， 你 需要 确认 在 项 目 里 添加 约束 布局 依赖 项 。 和 RecyclerView 类 似 ， 
ConstraintLayout 也 包含 在 某 个 库 里 。 所 以 , 知 要 使 用 它 ，: 要 么 手动 添加 ， 要 么 点 击 OK 按 钮 确 
认 ， 让 Android Studio 帮 你 添加 。 


本 Add Project Dependency 
A This operation requires the library 


' constraint-layout- 
全 








Would you like to add this library now? 


Cancel 3 











图 9-7 添加 ConstraintLayout 依 赖 项 


查看 app/build.gradle 文 件 ， 可 以 看 到 依赖 项 已 经 添加 成 功 ， 如 代码 清单 9-1 所 示 。 
代码 清单 9-1 内 边 距 属性 的 实际 应 用 ( fragment_crime.xml ) 


dependencies { 
compile 'com.android.support.constraint:constraint-layout:l.0.0-beta4' 
} 


就 这 样 ，LinearLayout 组 件 已 经 成 功 转换 为 ConstraintLayout 组 件 。 


9.2.2 ”约束 编辑 器 





如 图 9-8 所 示 ， 靠 近 布 局 预览 窗口 顶部 的 工具 栏 上 ， 你 可 以 看 到 一 些 约束 编辑 选项 。 下 面 看 
一 下 它们 分 别 有 什 么 作用 。 


口 显示 所 有 约束 


显示 你 在 预览 和 蓝图 视图 里 创建 的 所 有 约束 。 这 个 控制 
果 你 有 大 量 的 约束 ， 点 击 这 个 控制 按钮 ， 估 计 你 














控制 项 有 时 很 用， 有 时 帮 倒 忙 。 如 
会 得 密集 恐惧 症 。 
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口 自动 连接 切换 开关 
启用 后 ， 在 预览 界面 拖 移 视图 时 ， 约 束 会 自动 配置 。Android Studio 会 猜测 你 的 视图 布置 
意图 ， 帮 你 自动 连接 。 
口 清除 全 部 约束 
清除 布局 中 的 所 有 约束 。 稍 后 就 会 用 。 
口 猜测 约束 
这 个 选项 类 似 自 动 连接 ，Android Studio 会 自动 帮 你 创建 约束 。 任 何 时 候 ， 只 要 你 向 布局 
文件 添加 视图 ， 自 动 连接 都 会 被 激活 。 
显示 所 有 约束 自动 连接 切换 开关 




















清除 全 部 约束 猜测 约束 
图 9-8 ”约束 编辑 选项 








转换 list item_crime 使 用 ConstraintLayout 时 , 根据 原 布局 的 视图 布置 , Android Studio 已 经 
自动 添加 了 约束 。 不 过 ， 为 了 观察 学 习 ， 我 们 得 从 头 开始 。 

在 组 件 树 里 选择 ConstraintLayout， 然 后 选择 图 9-8 里 的 “清除 全 部 约束 ”选项 。 你 会 立即 
看 到 红色 警告 标志 ， 上 面 显示 数字 4。 点 击 它 看 看 究竟 怎么 回 事 〈 图 9-9 )。 


Lint Warnings in Layout 

















Error This view is not constrained, it only has designtime positions, so it will jump to (0,0) unless ya 
Error: This view is not constrained, it only has designtime positions, so it will jump to (0,0) unless yo 
Warning: [I18N] Hardcoded string "Crime Date", should use “@string. resource 
Warning: [I18N] Hardcoded string "Crime Title", should use “@string™ resource 


Applies To: lssue Explanation: 


crime_title at (8,89) dp Message: This view is not constrained, it only has 
designtime positions, so it will jump to (0,0) unless you 
add constraints 
Suggested Fixes: 


BOE - Suppress: Add tools:ignore="MissingConstraints” 
attribute 





Gime cate Priority: 6 / 10 
Category: Correctness 
Severity: Error 
Explanation: Missing Constraints in ConstraintLayout. 
The layout editor allows you to place widgets anywhere on 
the canvas, and it records the current position with 
designtime attributes (such as layout_editor_absoluteX.) 


Show warnings or error icons on the design surface 


图 9-9 ”ConstraintLayout 警 告 











原来 , 视图 没有 足够 的 约束 ，ConstraintLayout 不 知道 该 如 何 布局 了 。TextView 组 件 根 本 
没有 约束 ， 所 以 它们 都 收 到 警告 说 ， 运 行 时 可 能 不 能 出 现在 正确 位 置 。 
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稍 后 , 我 们 会 添加 上 需要 的 约束 修正 这 个 问题 。 添 加 过 程 中 ,注意 查看 是 否 有 警告 信息 ， 以 
避免 运行 时 的 异常 行为 。 
9.2.3” 腾 出 空间 


两 个 TextView 组 件 占 据 了 整个 区 域 ， 再 难 容 下 其 他 组 件 。 现 在 ， 需 要 把 它们 缩小 。 
在 组 件 树 里 ， 选 中 crime _titte， 然 后 查看 右边 的 属性 视图 窗口 ， 如 图 9-10 所 示 。 

















Properties 4 | 
ID | crime title ] 
LA 
宽度 设置 高 度 设置 
layout_width | 368dp 
layout_height wrap_content 











加 


性 





图 9-10 ”TextView 的 


TextView 水 平方 向 和 竖 直 方向 的 尺寸 是 分 别 由 宽度 设置 和 高 度 设置 决定 的 ,能 设置 的 值 有 以 
下 三 种 ， 如 图 9-11 所 示 。 每 种 值 都 对 应 Layout_width 或 Layout_height 的 一 个 值 。 














固定 大 小 包 夺 内 容 态 适应 
layout_width | 86dp layout_width [wrap_content | layout_width [odp | 





layout_height | 22dp layout_height | wrap_content layout_height | odp 


图 9-11 三 种 视图 尺寸 设置 











表 9-1 视图 尺寸 设置 类 型 





























设置 类 型 设置 值 用 法 
同 定 大 小 Xdp 以 dp 为 单位 ， 为 视图 指定 固定 值 (dp 稍 后 介绍 ) 
包 庄 内 容 wrap_content 设置 视图 想 要 的 尺寸 ( 随 内 容 走 ) ， 也 就 是 说 ， 大 到 足够 容纳 内 容 
































动态 适应 0dp 允许 视图 缩放 以 满足 指定 约束 
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当前 ，crime title 和 crime_ date 都 设 定 了 一 个 最 大 的 固定 宽度 值 ， 所 以 占据 了 整个 屏幕 。 
选中 crime title, 把 宽度 值 设 为 wrap_content, 如 果 有 必要 , 把 高 度 值 也 设 为 wrap_content ， 


如 图 9-12 所 示 。 














Properties 本 


ID crime_titie 





layout_width wrap_content 





layout_height wrap_content 


图 9-12 ”调整 crime_ title 的 宽 高 值 





重 苹 在 一 起 














重复 上 述 步骤 ,设置 crime_date 的 宽 高 值 。 现 在 这 两 个 组 件 小 一 些 了 ， 并且 还 
如 图 9-13 所 示 。 


二 看 6:00 
Criminallntent 


Crime Dale 








mm 





县 的 TextView 


[ey 





图 9-13 是 
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9.2.4 添加 组 件 


处 理 完 两 个 TextView， 可 以 向 布局 里 添加 手 钳 图 片 了 。 首 先 添加 一 个 ImageView 视 图 。 在 


组 件 面板 里 找到 ImageView 组 件 (图 9-14 )， 把 它 拖 和 人 组件 树 ， 并 作为 ConstraintLayout 的 子 组 
件 ， 放 在 crime date 下 面 。 


[SIDEaLVISVW 
让 Images & Media 

国 ImageButton 

回 VideoView 
口 Date & Time 

二 TimePicker 


图 9-14 ”找到 ImageView 组 件 


在 随后 弹出 的 对 话 框 里 ， 选 择 ic_solved 作 为 ImageView 组 件 的 资源 ， 如 图 9-15 所 示 。 这 个 
图 片 用 来 表明 crime 已 经 解决 。 

















© ie® Resources 
a 国 Add new resourcev 
Y Project SS 
Drawable Name: ic_solved 
颖 ic_launcher 
Color 
ic_solved 
android 
| alert_dark_frame 
这 于 


ee alert_light_frame 


Ey arrow_down_float 





EA arrow_up_float 


cas 





图 9-15 ”选择 ImageView 组 件 资源 





ImageView 组 件 添加 完了 ， 但 它 还 没有 任何 约束 。 虽 然 它 现在 有 个 位 置 ， 但 这 个 位 置 没 有 任 
何 意义 。 


现在 为 它 添加 约束 。 在 组 件 树 或 者 预览 界面 里 选中 ImageView 组 件 ， 可 看 到 它 的 四 边 都 有 圆 
点 ， 如 图 9-16 所 示 。 这 些 点 表示 约束 柄 。 








图 9-16 ImageView 组 件 的 约束 柄 
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按照 设计 构想 ，ImageView 组 件 要 放 在 视图 的 右边 。 这 需要 给 ImageView 组 件 的 上 、 下 和 右 
三 条 边 添 加 约束 。 

首先 来 设置 ImageView 组 件 顶部 和 ConstraintLayout 组 件 顶 部 之 间 的 约束 。Constraint- 
Layout 组 件 顶 部 不 容易 看 到 , 但 实际 上 它 就 在 CriminalIntent 蓝 色 工 具 栏 的 下 面 。 在 预览 界面 , 拖 
住 ImageView 组 件 顶 部 的 约束 柄 ， 将 其 拖 向 ConstraintLayout 组 件 顶 部 。 因 为 这 两 个 组 件 顶部 
比较 接近 ,所 以 拖 的 时 候 可 能 要 多 试 几 次 ,直到 约束 柄 变 绿 , 并 弹出 Release to Create Top Constraint 
这 样 的 提示 时 ( 如 图 9-17 所 示 )， 再 松 开 鼠标 。 
























Release to Create 
Top Constraint 





图 9-17 创建 顶部 约束 


注意 ， 光 标 变 为 拐角 形状 时 ， 不 要 点 击 ， 因 为 这 会 改变 ImageView 组 件 的 尺寸 。 另 外 ， 还 要 
小 心 别 把 约束 设 到 TextView 组 件 上 。 如 果真 的 搞 错 了 ， 就 点 击 约束 柄 删 掉 后 重 做 。 

松 开 鼠标 设置 约束 时 ， 视 图 会 立即 就 位 以 表明 现在 有 了 一 个 新 约束 。 这 就 是 视图 在 
ConstraintLayout 里 摆 放 的 方式 一 一 设置 和 删除 约束 。 

想 确 认 ImageView 顶 部 和 ConstraintLayout 顶 部 是 不 是 已 经 连接 了 约束 ， 可 在 ImageView 
悬 停 女 标 ， 如 果 是 ， 应 该 会 出 现 如 图 9-18 所 示 的 形状 。 





























Criminallntent 








图 9-18” 带 顶部 约束 的 ImageView 


按 同样 的 方式 ， 拖 住 ImageView 组 件 底部 的 约束 柄 ， 拖 到 根 视图 的 底部 。 同 样 ， 不 要 拖 到 
TextView 上 。 如 图 9-19 所 示 ， 这 次 是 向 根 视图 的 中 间 向 下 慢 拖 。 





Criminalintent 

















图 9-19 ”ImageView 组 件 约束 设置 进行 中 
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最 后 ， 向 根 视图 右边 拖 鼻 ImageView 的 右 约 束 柄 ， 设 置 右边 约束 。 完 成 后 ， 将 鼠标 悬 停 在 
ImageView 组 件 上 ， 确 认 所 有 的 约束 都 正确 设置 ， 如 图 9-20 所 示 。 








Criminallntent 





Crime Dabe 


图 9-20 ”ImageView 上 设置 了 三 个 约束 





9.2.5 ”约束 的 XML 形式 


最 终 ， 图 形 约束 编辑 窗口 的 任何 编辑 都 会 体现 在 XML 文件 里 。 当 然 ， 如 果 你 愿意 ， 还 是 可 
以 直接 编辑 原生 ConstraintLayout XML。 不 过 ， 显 然 还 是 使 用 图 形 约 束 编辑 器 更 为 方便 。 

将 布局 切换 到 XML 文件 模式 ， 看 看 刚刚 为 ImageView 创 建 的 三 个 约束 都 向 XML 文件 里 添加 
了 什么 内 容 ， 如 代码 清单 9-2 所 示 。 


代码 清单 9-2 ImageView 约 束 的 XML 形式 (layouUlist item crime.xml ) 


<android.support.constraint.Constraintlayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="wrap_ content"> 















































<imageView 
android:id="@+id/imageView" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
app:srcCompat="@drawable/ic solved" 
android:layout marginTop="l6dp" 
app:layout constraintTop toTop0Of="parent" 
app:layout constraintBottom toBottom0f="parent" 
android:layout marginBottom="l6dp" 
android:layout marginEnd="1l6dp" 
app:layout constraintRight toRight0f="parent"/> 


</android.support.constraint.Constraintlayout> 

以 顶部 约束 为 例 ， 我 们 来 审视 一 下 它 的 属性 设置 : 

app:layout constraintTop toTop0f="parent" 

这 个 属性 以 Layout_ 开头。 凡是 以 Layout_ 开头 的 属性 都 属于 布局 参数 (layout parameter )。 
与 其 他 属性 不 同 的 是 , 组 件 的 布局 参数 是 用 来 向 其 父 组 件 做 指示 的 , 即 用 于 告诉 父 布局 如 何 安排 
自己 。 目前 为 止 , 我 们 已 经 见识 过 好 几 个 这 样 的 布局 参数 , 如 Layout_width 和 Layout_height。 
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约束 的 名 字 是 constraintTop。 这 表示 它 是 ImageView 的 顶部 约束 。 


最 后 , 属性 以 toTopof="parent" 结 束 , 这 表明 , 约束 是 连接 到 父 组 件 ( ConstraintLayout ) 
顶部 的 。 


好 了 , 一 口气 看 了 这 么 多 ， 软 一 吹 。 不 过 ， 事 情 还 没完 ， 又 该 回 到 图 形 约束 编辑 窗口 了 。 
9.2.6 ”编辑 属性 






































现在 ，ImageView 组 件 已 经 摆 放 正确 了 。 接 下 来 的 任务 是 布置 和 调整 标题 TextView 组 件 。 
首先 ， 在 组 件 树 里 选中 crime_date， 把 它 拖 忠 到 别处 ， 如 图 9-21 所 示 。 注 意 ， 在 预览 界面 ， 


拖 到 别处 看 上 去 是 换 了 位 置 , 但 应 用 运行 时 ， 你 依然 看 不 到 这 种 位 置 变化 。 不 过 ,使 用 约束 调整 
位 置 就 可 以 。 











志 自 6:00 
Criminallntent 


Crime Title 


do 


Crime Date 
图 9-21 把 crime date 拖 到 别处 
现在 ,在 组 件 树 里 选中 crime_title 视 
的 左边 。 这 需要 添加 以 下 三 个 约束 : 
口 从 crime_title 视 图 的 左边 到 其 父 组 件 的 左边 ， 带 16dp 的 边 距 ; 
口 从 crime title 视 图 的 顶部 到 其 父 组 件 的 顶部 ， 带 16dp 的 边 距 ; 
口 从 crime title 视 图 的 右边 到 ImageView 组 件 的 左边 ， 带 8dp 的 边 距 。 
创建 上 述 约 束 。( 定位 、 拖 中 需要 耐心 和 技巧 ， 不 行 就 多 用 Command+2Z 或 Ctrlt+Z ) 撤销 快 损 
键 反 复试 几 次 。) 
确认 约束 都 添加 完成 ， 如 图 9-22 所 示 ( 选中 组 件 就 能 看 到 )。 























图 。 它 的 目标 位 置 是 布局 的 左上 角 ，ImageView 组 件 


一 














I CC 


~ 














人 





Criminallntent 





上 rime Title 





Crime Date 


So 
图 9-22 ”TextView 视 图 的 约束 
注意 ， 点 击 TextView 时 ， 会 看 到 它 有 一 块 椭圆 区 域 ， 而 ImageView 没 有 。 这 是 TextView 用 
来 对 齐 文字 的 特有 约束 锚 点 。 不 过 ， 本 章 用 不 到 ， 了 解 就 行 。 
搞定 了 crime_title 的 约束 , 现在 设置 视图 尺寸 。 视 图 宽度 设置 为 动态 适应 ( 0dp )， 这 样 标 
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题 文 字 就 可 以 占 满 约束 间 的 空间 。 视 图 高 度 设置 为 wrap_content， 以 便 刚 好 显示 出 crime 标 题 。 
最 后 ,确认 设置 结果 如 图 9-23 所 示 。 








Properties 4 | 党- 训 





ID 

















layout_width | 0dp 








layout_height | wrap_content 








图 9-23 crime title 视 图 设置 


接 下 来 处 理 crime_date 视 图 。 在 组 件 树 里 选中 它 ， 为 其 添加 以 下 三 个 约束 : 
口 从 crime_date 视 图 的 左边 到 其 父 组 件 的 左边 ， 带 16dp 的 边 距 ; 
口 从 crime_date 视 图 的 顶部 到 crime title 视 图 的 底部 ， 带 8dp 的 边 距 ; 
口 从 crime_date 视 图 的 右边 到 ImageView 组 件 的 左边 ， 带 8dp 的 边 距 。 
完成 约束 设置 后 ， 开 始 设置 视图 尺寸 。 和 crime title 视 图 一 样 , 设置 视图 宽度 为 动态 适应 
( 0dp )， 高 度 为 wrap_content。 最 后 ， 确 认 设置 结果 如 图 9-24 所 示 。 














Properties 4 | 措 -- 











ID crime_date 








layout_width 0dp 


layout_height wrap_content 


图 9-24 ”crime date 视图 设置 
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现在 ， 查 看 预览 ， 应 该 能 看 到 类 似 图 9-1 的 显示 效果 。 
运行 CriminalIntent 习 用 , 确认 三 个 组 件 在 RecyclerView 视 图 都 显示 得 上 下 齐整 、 琉 沙 有 致 ， 


如 图 9-25 所 示 。 
A700 


Crime #0 ® 
EO 


Mon Dec 12 14:45:54 EST 2016 


Crime #1 
Mon Dec 12 14:45:54 EST 2016 


Crime #2 9 
tO 


Mon Dec 12 14:45:54 EST 2016 


Crime #3 
Mon Dec 12 14:45:54 EST 2016 


Crime #4 9 


Mon Dec 12 14:45:54 EST 2016 


Crime #5 
Mon Dec 12 14:45:54 EST 2016 


Crime #6 9 
tO 


Mon Dec 12 14:45:54 EST 2016 


Crime #7 
Mon Dec 12 14:45:54 EST 2016 


Crime #8 9 
EO 


Mon Dec 12 14:45:54 EST 2016 


图 9-25 ”图 形 布局 工具 中 的 视图 














9.2.7 ”动态 设置 列表 项 


当前 , 应 用 运行 时 , 每 行 都 显示 了 手 钳 图 片 。 这 和 实际 不 符 , 需要 修改 ImageView 组 件 解 决 。 

首先 ， 更 新 ImageView 组 件 的 ID (组 件 添 加 时 已 设置 了 默认 名 )。 在 组 件 树 里 选中 它 ， 然 后 
在 视图 属性 窗口 将 ID 修改 为 crime_soLved， 如 图 9-26 所 示 。Android Studio 会 询问 是 否 更 新 所 有 
用 到 该 ID 的 地 方 ， 点 Yes 确 认 。 




















Properties | 





ID | crime_solved| | 


1 1c 


图 9-26 ”更 新 ImageView 组 件 的 ID 

















更 新 完 ID， 代 码 也 要 做 对 应 更 新 。 打 开 CrimeListFragment.java 文 件 ， 在 CrimeHolder 类 中 ， 
添加 一 个 ImageView 实 例 变量 。 然 后 ， 根 据 crime 记 录 的 解决 状态 ， 控 制图 片 的 显示 ， 如 代码 清 
单 9-3 所 示 。 








代码 清单 9-3 控 





9.3 
央 图 片 显示 (CrimeListFragment.java ) 


深入 学 习 布 局 属 
private class CrimeHolder extends RecyclerView.ViewHolder 
implements View.OnClicklistener { 
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private TextView mDateTextView; 


private ImageView mSolvedImageView; 
public CrimeHolder(layoutinflater inflater 


itemView.setOnClicklistener(this); 


ViewGroup parent) { 
} 


super(inflater.inflate(R.layout.list item crime, parent, false)); 


mTitleTextView = (TextView) itemView.findViewByid(R.id.crime title); 


mDateTextView = (TextView) itemView.findViewByid(R.id.crime date); 
mCrime = crime; 


mSolvedImageView = (ImageView) itemView.findViewById(R.id.crime_ solved); 
public void bind(Crime crime) { 








mTitleTextView.setText(mCrime.getTitle()); 
mDateTextView.setText(mCrime.getDate().toString()); 
mSolvedImageView.setVisibility(crime.isSolved() ? View.VISIBLE : View.GONE); 
} 
} 
运行 CriminalIntent 应 用 。 确 认 手 铸 图 片 能 按 问题 解决 情况 正确 显示 。 
ia 《 
9.3 学 习 布 局 属性 
属性 相关 问题 。 





整 一 些 属 性 


Lo 





回 到 list item_crime.xml 布 局 





本 节 , 我 们 再 来 微调 一 下 list item_crime.xml 布 局 设计 , 同时 解答 一 些 可 


图 形 设计 界面 。 


中 criem title 





人 困扰 的 组 件 与 








河 


， 在 属 
点 击 textAppearance 旁 边 的 箭头 ， 显 示 出 各 种 显示 文字 和 字体 属 
全 病 量 id color/black， 如 图 9-27 所 示 。 





性 视图 窗口 ,我 们 来 调 





textColor 


生 。 修 改 textCotLor 
图 








属性 





三 
如 











@android:color/black 

图 9-27 更 新 标题 颜色 

然后 ， 再 设置 textSize 属 性 值 为 18sp。 运 行 应 月 
9.3.1 

















dp、sp 以 及 屏幕 像素 密度 
和 ist i 





月 。 可 以 看 到 ， 


整个 界面 的 显示 效果 非常 好 

















在 list item_crime.xml 文 件 中 ,我们 以 sp 和 dp 为 单位 指定 了 属性 值 .下 面 我 们 来 具体 学 习 一 下 
有 时 需要 为 视图 属性 指定 大 小 尺寸 值 (通常 以 像素 为 单位 


有 时 也 用 点 、 毫 米 或 英寸 )。 
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些 常 见 的 属性 包括 文字 大 小 ( text size )、 边 距 (margin ) 以 及 内 边 距 (padding )。 文 字 大 小 指定 
设备 上 显示 的 文字 像素 高 度 ; 边 距 指 定 视 图 组 件 间 的 距离 ; 内 边 距 指定 视图 外 边框 与 其 内 容 间 的 
距离 。 

在 2.6 节 中 ， 我 们 在 各 个 带 屏幕 密度 修饰 的 drawable ( 如 drawable-xhdpi ) 下 准备 了 对 应 的 
图 片 文 件 ，Android 会 用 它们 自动 适 配 不 同 像素 密度 的 屏幕 。 那 么 问题 来 了 ， 假 如 图 片 能 自动 适 
配 ， 但 边 距 无 法 缩放 适 配 ， 或 者 用 户 配置 了 大 于 默认 值 的 文字 大 小 ， 会 发 生 什 么 情况 呢 ? 

为 解决 这 些 问 题 ，Android 提 供 了 与 密度 无 关 的 尺寸 单位 。 运 用 这 种 单位 ， 可 在 不 同 屏幕 像 
素 密 度 的 设备 上 获得 同样 的 尺寸 。 无 需 麻 烦 的 转换 计算 ， 应 用 运行 时 ，Android 会 自动 将 这 种 单 
位 转换 成 像素 单位 ， 如 图 9-28 所 示 。 





























































Text size =15dp Text size = 15dp 






Text size = 15sp Text size = 15sp Text size = 15sp 
Text size = 30px 
Text size = 30dp 


Text size = 30sp 


Text size = 30px 


Text size = 30dp 


Text size = 30px 


Text size = 30dp 
Text size = 30sp 







Text size = 30sp 














MDPI HDPI HDPI, 大 字体 














图 9-28 ”使 用 与 密度 无 关 的 尺寸 单位 时 ，TextView 的 显示 效果 











口 px 
英文 pixel 的 缩写 ， 即 像素 。 无 论 屏幕 密度 多 少 ， 一 个 像素 单位 对 应 一 个 屏幕 像素 单位 。 
不 推荐 使 用 px， 因 为 它 不 会 根据 屏幕 密度 自动 缩放 。 

口 dp (或 dip ) 
英文 density-independent pixel 的 缩写 ， 意 为 密度 无 关 像素 。 在 设置 边 距 、 内 边 距 或 任何 不 
打算 按 像素 值 指定 尺寸 的 情况 下 ， 通 常 都 使 用 dp 这 种 单位 。 如 果 屏 幕 密度 较 高 ， 密 度 无 
关 像 素 会 相应 扩展 至 整个 屏幕 。1dp 在 设备 屏幕 上 总 是 等 于 1/160 英 寸 。 使 用 dp 的 好 处 是 ， 
无 论 屏 幕 密度 如 何 ， 总 能 获得 同样 的 尺寸 。 

口 Sp 
英文 scale-independent pixel 的 缩写 ， 意 为 缩放 无 关 像素 。 它 是 一 种 与 密度 无 关 的 像素 ， 这 
种 像素 会 受用 户 字体 偏好 设置 的 影响 。 通 常 使 用 sp 来 设置 屏幕 上 的 字体 大 小 。 
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口 pt、mm、hmn 


类 似 于 dp 的 缩放 单位 ， 允 许 以 点 (1/72 英寸 )、 上 毫米 或 英寸 为 单位 指定 用 户 界面 尺寸 。 但 
在 实际 开发 中 不 建议 使 用 这 些 单位 ， 因 为 并 非 所 有 设备 都 能 按照 这 些 单位 进行 正确 的 尺 











寸 缩 放 配 置 。 
在 本 书 及 实际 开发 中 ， 通 常 只 会 用 到 dp 和 sp 这 两 种 单位 。Android 会 在 运行 时 自动 将 它们 的 
值 转换 为 像素 单位 。 





9.3.2 边 距 与 内 边 距 








本 
疝 


有 时 分 不 清 这 两 个 属性 。 既 然 你 已 明白 什么 是 布局 参数 ,那么 二 者 的 区 别 也 就 显而易见 了 。 
边 距 属 性 是 布局 参数 , 决定 了 组 件 间 的 距离 。 由 于 组 件 对 外 界 一 无 所 知 ， 因 此 边 距 必须 由 该 
组 件 的 父 组 件 负 责 。 
内 边 距 不 是 布局 参数 。 属性 android:padding 告 诉 组 件 : 在 绘制 组 件 自身 时 , 要 比 所 含 内 容 
大 多 少 。 举 例 说 明 : 在 不 改变 文字 大 小 的 情况 下 ， 想 把 日 期 按钮 变 大 一 些 ， 如 图 9-29 所 示 。 


在 GeoQuiz 和 CriminalIntent 这 两 个 应 用 中 ， 我 们 给 组 件 设置 过 边 距 与 内 边 距 属性 。 开 发 新 手 
















































































TITLE 


Enter a title for the crime. 





DETAILS 





口 solved 








图 9-29 ”实话 实说 ， 我 喜欢 大 按钮 








可 将 下 面 的 属性 添加 给 Button， 如 代码 清单 9-4 所 示 。 
代码 清单 9-4 ”内 边 距 属 性 的 实际 应 用 ( fragment crime.xml ) 


<Button android:id="@+id/crime date" 
android:layout width="match parent" 
android:layout height="wrap content" 
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android:layout marginLeft="16dp" 
android:layout marginRight="16dp" 
android:padding="80dp" /> 


大 按钮 很 方便 ,但 很 可 惜 ， 继 续 学 习 前 ， 还 是 应 该 删除 这 个 属性 。 
9.3.3 样式、 主题 及 主题 属性 


样式 (style ) 是 XML 资 源 文件 ,含有 用 来 描述 组 件 行为 和 外 观 的 属性 定义 。 例 如 ,使 用 下 列 
样式 配置 组 件 ， 就 能 显示 比 正常 大 小 更 大 的 文字 : 


<style name="BigTextStyle"> 
<item name="android:textSize">20sp</item> 
<item name="android:padding">3dp</item> 
</style> 


你 可 以 创建 自己 的 样式 文件 (第 22 章 会 这 样 做 )。 具 体 做 法 是 将 属性 定义 添加 并 保存 在 
res/values/ 目 录 下 的 样式 文件 中 ， 然 后 在 布局 文件 中 以 @style/my_own_style (样式 文件 名 ) 的 
形式 引用 。 

再 来 看 看 fragment_crime.xml 文 件 中 的 两 个 TextView 组 件 。 每 个 组 件 都 有 一 个 引用 Android 自 
带 样式 文件 的 stytLe 属 性 。 该 预定 义 样 式 来 自 于 应 用 的 主题 , 能 让 屏幕 上 的 TextView 组 件 看 起 来 
是 以 列表 样式 分 隔 开 的 。 主 题 是 各 种 样式 的 集合 。 从 结构 上 来 说 ， 主 题 本 身 也 是 一 种 样式 资源 ， 
只 不 过 它 的 属性 指向 了 其 他 样式 资源 。 

Android 自 带 了 一 些 供 应 用 使 用 的 平台 主题 。 例 如 ， 在 创建 CriminalIntent 应 用 时 ， 向 导 就 设 
置 了 默认 主题 ( 是 在 manifest 文 件 的 appLication 标 签 下 引用 的 )。 

使 用 主题 属性 引用 ， 可 将 预定 义 的 应 用 主题 样式 添加 给 指定 组 件 。 在 fragment_crime.xml 文 
件 中 ,样式 属性 值 ?android:1listSeparatorTextViewStyle 的 使 用 就 是 这 样 一 个 例子 。 

使 用 主题 属性 引用 ， 就 是 告诉 Android 运 行 资源 管理 器 :“ 在 应 用 主题 里 找到 名 为 List- 
SeparatorTextViewStyle 的 属性 。 该 属性 指向 其 他 样式 资源 ， 请 将 其 资源 的 值 放 在 这 里 。” 

所 有 Android 主 题 都 包括 名 为 ListSeparatorTextViewStyle 的 属性 。 不 过 ， 基 于 特定 主题 
的 整体 风格 ,它们 的 定义 稍 有 不 同 。 使 用 主题 属性 引用 ， 可 以 确保 TextView 组 件 在 应 用 中 拥有 
正确 一 致 的 显示 风格 。 

你 还 会 在 第 22 章 学 习 到 更 多 有 关 样 式 及 主题 的 使 用 知识 。 





















































































































































9.3.4 Android 应 用 的 设计 原则 


注意 看 边 距 属性 ，Android Studio 默 认 使 用 的 值 是 16dp 或 8dp。 设 定 这 两 种 值 遵循 了 Android 
的 material design 原 则 。 访 问 developer.android.com/design/index.html， 可 看 到 所 有 的 Android 设 计 
规范 。 

开发 Android 应 用 都 应 严格 遵循 这 些 设计 原则 。 不 过 ， 这 些 设计 原则 严重 依赖 于 SDK 较 新 版 
本 的 功能 ， 旧 版 本 设备 往往 无 法 获得 或 实现 这 些 功能 。 不 过 有 些 设计 可 借助 AppCompat 库 实现 ， 
详 见 第 13 章 。 
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9.4 图 形 布局 工具 使 用 小 结 


图 形 布 局 工具 非常 有 用 ， 有 了 ConstraintLayout 更 是 如 虎 添 器 。 然 而 ， 人 各 有 所 爱 ， 很 多 
开发 人 员 更 喜欢 简单 直 白 的 XML。 

别 犯 选择 困难 症 啦 ! 图 形 布局 工具 也 好 ， 写 XML 也 好 ， 反 正 可 以 随时 切换 ， 怎 么 方便 就 怎 
么 来 吧 ! 在 后 续 章 节 中 ， 如 果 需 要 创建 布局 ,我 们 只 会 提供 布局 结构 示意 图 ， 具体 怎么 实现 ,你 
自己 定 。 


9.5 ”挑战 练习 : 日 期 格式 化 


与 其 说 Date 对 象 是 普通 日 期 ， 不 如 说 是 时 间 惟 。 调 用 Date 对 象 的 toSstring () 方 法 ， 就 角 
到 一 个 时 间 惟 。 所 以 ，RecyctLerview 视 图 上 显示 的 就 是 它 。 时 间 戳 虽然 凑合 能 用 ， 但 如 果 生 
示人 们 习惯 看 到 的 日 期 应 该 会 更 好 ， 如 “Jul 22, 2016”。 要 实现 此 目标 ， 可 使 用 android . 
text .format.DateFormat 类 实例 。 具 体 怎 么 用 ， 请 查阅 Android 文 档 库 中 有 关 该 类 的 说 明 。 

使 用 DateFormat 类 中 的 方法 ， 可 获得 常见 格式 的 日 期 ; 也 可 以 自己 定制 字符 串 格式 。 最 后 ， 
再 来 一 个 更 有 挑战 的 练习 : 创建 一 个 包含 星期 的 字符 串 格 式 ， 如 “Friday, Jul 22, 2016”。 
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使 用 fragment argument 











本 章 ， 我 们 将 关联 CriminalIntent 应 用 的 列表 与 明细 部 分 。 用 户 点 击 某 个 crime 列 表 项 时 ， 会 
创建 一 个 托管 CrimeFragment 的 CrimeActivity， 以 展现 Crime 实 例 的 明细 信息 。 

在 GeoQuiz 应 用 里 , 我 们 已 实现 从 activity ( QuizActivity ) 中 启动 activity ( CheatActivity )。 
在 CriminalIntent 应 用 里 ， 我们 要 实现 从 fragment 中 启动 CrimeActivity。 准 确 地 说 ， 是 从 
CrimeListFragment 中 启动 CrimeActivity 实 例 ， 如 图 10-1 所 示 。 


CrimeListActivit 
二 


CrimeListFragment CrimeFragment 


图 10-1 从 CrimeListActivity 中 启动 CrimeActivity 




















10.1 从 fragment 中 启动 activity 


从 fragment 中 启动 activity 类 似 于 从 activity 中 启动 activity。 我 们 调用 Fragment.start 
Activity(Intent) 方 法 ， 由 它 在 后 台 再 调用 对 应 的 Activity 方 法 。 
在 CrimeListFragment 的 CrimeHolder 类 里 , 用 启动 CrimeActivity 实 例 的 代码 , 替换 toast 


消息 处 理 代码 ， 如 代码 清单 10-1 所 示 。 





























代码 清单 10-1 启动 CrimeActivity (CrimeListFragment.java ) 


private class CrimeHolder extends RecyclerView.ViewHolder 
impLements View.OnClickListener { 


@Override 
public void onClick(View view) { 
于 Ke Activity 人 
i + " clicked!'", Toast.LENGTH_SHORT) 
=Show(}; 
Intent intent = new Intent(getActivity(), CrimeActivity.class); 
startActivity(intent); 





10.1 从 fragment 中 局 动 activity 169 





指定 要 启动 的 activity 为 CrimeActivity，CrimeListFragment 创 建 了 一 个 显 式 intent。 至 于 
Intent 构 造 方法 需要 的 Context 对 象 ，CrimeListFragment 是 通过 使 用 getActivity() 方 法 传 
入 它 的 托管 activity 来 满足 的 。 

运行 CriminalIntent 应 用 。 点 击 任意 列表 项 , 托管 CrimeFragment 的 新 CrimeActivity 随 即 出 
现在 屏幕 上 ， 如 图 10-2 所 示 。 


A 7:00 
Criminalintent 


TITLE 








Enter a title for the crime. 


DETAILS 


[0D solved 











图 10-2 ”空白 的 CrimeFragment 


由 于 不 知道 该 显示 哪个 Crime 对 象 ， 因 此 CrimeFragment 没 有 显示 出 具体 的 Crime 信 息 。 








10.1.1 附加 extra 信息 


启动 CrimeActivity 时 ， 传 递 附 加 到 Intent extra 上 的 crime ID ，CrimeFragment 就 能 知道 该 
显示 哪个 Crime。 
这 需要 在 CrimeActivity 中 新 增 newIntent 方 法 ， 如 代码 清单 10-2 所 示 。 
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代码 清单 10-2 创建 newIntent 方 法 ( CrimeActivity.java ) 


public class CrimeActivity extends SingLeFragmentActivity { 


public static final String EXTRA CRIME ID = 
"com.bignerdranch.android.criminalintent.crime id"; 


public static Intent newIntent(Context packageContext, UUID crimeId) { 
Intent intent = new Intent(packageContext, CrimeActivity.class); 
intent.putExtra(EXTRA CRIME ID, crimeld); 
return intent; 


} 














创建 了 显 式 intent 后 , 调用 putExtra(.,.) 方 法 , 传 入 匹配 crimeId 的 字符 串 键 与 键 值 。 这 里 ， 
由 于 UUID 是 Serializable 对 象 ， 因 此 我 们 需要 调用 putExtra(String，Serializable) 方 法 。 


更 新 CrimeHoLder， 使 用 newIntent 方 法 ， 如 代码 清单 10-3 所 示 。 


代码 清单 10-3 ”传递 Crime 实 例 ( CrimeListFragment.java ) 


private class CrimeHolder extends RecyclerView.ViewHolder 
implements View.OnClickListener { 


@Override 

public void onClick(View view) { 
I ， = 了 Aetivity(), CrimeActivi 1 ); 
Intent intent = CrimeActivity.newIntent(getActivity(), mCrime.getId()); 
startActivity(intent); 





10.1.2 ”获取 extra 信息 


crime ID 现 已 安全 存储 到 CrimeActivity 的 intent 中 。 然 而 ， 要 获取 和 使 用 extra 信 息 的 是 





CrimeFragment 类 。 











fragment 有 两 种 方式 获取 intent 中 的 数据 : 一 种 简单 直接 ， 另 一 种 复杂 但 比较 灵活 (涉及 


fragment argument 的 概念 )。 


我 们 首先 来 看 简单 的 方式 : CrimeFragment 直 接 使 用 getActivity() 方 法 获取 CrimeActivity 


























日 它 获 取 





的 intent。 回 到 CrimeFragment.java 文 件 ， 取 到 CrimeActivity 的 intent 内 的 extra 人 信息， 再 月 
Crime 对 象 ， 如 代码 清单 10-4 所 示 。 


代码 清单 10-4 ”获取 extra 数 据 并 取得 Crime 对 象 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 











public void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 
CE TE = Crime(); 
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UUID crimeId = (UUID) getActivity() .getIntent() 
.getSeriaLizabLeExtra(CrimeActivity.EXTRA_CRIME_ID); 
mCrime = CrimeLab.get(getActivity()).getCrime(crimeId) ; 


} 

在 代码 清单 10-4 中 , 除了 getActivity() 方 法 的 调用 ,获取 extra 数 据 的 实现 代码 与 activity 里 
获取 extra 数 据 的 代码 一 样 。getIntent() 方 法 返回 用 来 启动 CrimeActivity 的 Intent， 然 后 调 
用 Intent 的 getSerializableExtra(String) 方 法 获取 UUID 并 存 人 变量 中 。 

取得 Crime 的 ID 后 ， 再 用 它 从 CrimeLab 单 例 中 调 取 Crime 对 象 。 











10.1.3 使 用 Crime 数据 更 新 CrimeFragment 视图 


既然 获取 到 了 crime 对象，CrimeFragment 视 图 便 可 显示 该 Crime 对 象 的 数据 了 。 人 参照 代码 
清单 10-5， 更 新 onCreateView(...) 方 法 ， 显 示 Crime 对 象 的 标题 及 解决 状态 。( 显示 日 期 的 代 
码 早已 就 绪 。) 


代码 清单 10-5 ”更 新 视图 对 象 ( CrimeFragment.java ) 


GOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container， 
Bundle savedInstanceState) { 

















mTitleField = (EditText)v.findViewById(R.id.crime title); 
mTitleField.setText (mCrime.getTitle()); 
mTitleField.addTextChangedListener(new TextWatcher() { 


}); 


mSolvedCheckBox = (CheckBox)v.findViewById(R.id.crime solved); 
mSolvedCheckBox.setChecked(mCrime.isSolved()); 
mSolvedCheckBox.setOnCheckedChangeListener(new OnCheckedChangeListener() { 


}); 
evr ye 
} 


运行 CriminalIntent 应 用 。 选 中 Crime 要， 查看 显示 了 正确 信息 的 CrimeFragment 实 例 ， 如 图 
10-3 所 示 。 
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WA 7:00 
Criminalintent 


TITLE 


Crime #4 





DETAILS 


Solved 








图 10-3 ”Crime 双 列 表 项 的 明细 内 容 


10.1.4 直接 获取 extra 信息 的 缺点 














只 需 几 行 简单 的 代码 ， 就 可 让 fragment 直 接 从 托管 activity 的 intent 中 获取 信息 。 然 而 ， 这 种 方 


式 破 坏 了 fragment 的 封装 。CrimeFragment 不 再 是 可 复 用 的 构建 单元 ， 因 为 它 现在 由 某 个 特定 的 
activity 托 管 着 ， 该 特定 activity 的 Intent 又 定义 了 名 为 com,bignerdranch.android.crimina- 


Lintent.crime id 的 extra。 














就 CrimeFragment 类 来 说 ， 这 看 起 来 合情合理 ; 但 这 也 意味 着 ， 按 照 当 前 的 编码 实现 ， 
CrimeFragment 便 再 也 无 法 用 于 任何 其 他 的 activity 了 。 





一 个 比较 好 的 做 法 是 ， 将 crime ID 存储 在 














属于 CrimeFragment 的 某 个 地 方 ， 而 不 是 保存 在 


CrimeActivity 的 私有 空间 里 。 这样, 无需 依 赖 CrimeActivity 的 intent 内 的 extra，CrimeFragment 
就 能 获取 自己 所 需 的 extra 数 据 。 属 于 fragment 的 “ 某 个 地 方 ” 实 际 就 是 它 的 argument bundle。 





10.2 fragment argument 





每 个 fragment 实 例 都 可 附带 一 个 Bundle 对 象 。 该 bundle 包 含 键 - 值 对 ， 我 们 可 以 像 附加 extra 








到 Activity 的 intent 中 那样 使 用 它们 。 一 个 键 - 值 对 即 一 个 argument。 
要 创建 fagment argument， 首 先 需 创建 Bbundle 对 象 。 然 后 ， 使 用 Bundle 限 定 类 型 的 put 方 法 
( 类似 于 Intent 的 方法 )， 将 argument 添 加 到 bundle 中 【〈 代码 如 下 所 示 )。 


Bundle args = new Bundle(); 





args.putSerializable(ARG MY OBJECT, myO0bject); 


args.putInt(ARG MY_INT, myInt); 


args.putCharSequence(ARG MY_ STRING, myString); 
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10.2.1 ”附加 argument 给 fragment 


要 附加 argument bundle 给 fragment， 需 调用 Fragment .setArguments (Bundle) 方 法 。 而 且 ， 
还 必须 在 fragment 创 建 后 、 添 加 给 activity 前 完成 。 

为 满足 以 上 要 求 ，Android 开 发 人 员 采 取 的 习惯 做 法 是 : 添加 名 为 newInstance() 的 静态 方 
法 给 Fragment 类 。 使 用 该 方法 ， 完 成 fagment 实 例 及 DundLe 对 象 的 创建 ， 然 后 将 argument 放 人 
bundle 中 ， 最 后 再 附加 给 fragment。 

托管 activity 需 要 fragment 实 例 时 ， 转 而 调用 newInstance () 方 法 ， 而 非 直接 调用 其 构造 方法 。 
而 且 ,为 满足 fragment 创 建 argeument 的 要 求 ,activity 可 给 newInstance() 方 法 传人 任何 需要 的 参数 。 

在 CrimeFragment 类 中 ， 编写 可 以 接受 UUID 参 数 的 newInstance (UUID) 方 法 ， 创建 argument 
bundle 和 fragment 实 例 ， 然 后 附加 argument 给 fragment， 如 代码 清单 10-6 所 示 。 


代码 清单 10-6 ”编写 newInstance(UUID) 方 法 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 





























private static final String ARG CRIME ID = "crime id"; 


private Crime mCrime; 

private EditText mTitleField; 
private Button mDateButton; 
private CheckBox mSolvedCheckbox; 


public static CrimeFragment newInstance(UUID crimeId) { 
Bundle args = new Bundle(); 
args.putSerializable(ARG CRIME ID, crimeld); 


CrimeFragment fragment = new CrimeFragment(); 
fragment.setArguments (args); 
return fragment; 


} 

现在 , 需 创建 CrimeFragmentH 时 , CrimeActivity 应 调用 CrimeFragment ,newInstance (UUID) 
方法 ,并 传人 从 它 的 extra 中 获取 的 UUID 参 数值 。 回 到 CrimeActivity 类 中 , 在 createFragment() 
方法 里 ， 从 CrimeActivity 的 intent 中 获取 extra 数 据 ， 并 传人 CrimeFragment .newInstance(UUID ) 
方法 ， 如 代码 清单 10-7 所 示 。 

既然 其 他 类 不 会 用 到 EXTRA_CRIME_ID， 可 以 将 其 改 为 私有 。 
代码 清单 10-7 使 用 newInstance(UUID) 方 法 (CrimeActivityjava) 


public class CrimeActivity extends SingleFragmentActivity { 











PubtLie private static final String EXTRA CRIME ID = 
"com.bignerdranch.android.criminalintent.crime id"; 


@Override 
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protected Fragment createFragment() { 


return hew CrimeFragment(); 

UUID crimeId = (UUID) getIntent() 
.getSerializableExtra(EXTRA_CRIME ID); 

return CrimeFragment .newInstance(crimeId) ; 


} 

注意 ，activity 和 fragment 不 需要 也 无 法 同时 相互 保持 独立 。CrimeActivity 必 须 了 解 
CrimeFragment 的 内 部 细节 ， 比 如 知道 它 内 部 有 个 newInstance(UUID) 方 法 。 这 很 正常 。 托 管 
activity 应 该 知道 这 些 细节 ， 以 便 托管 fagment; 但 fragment 不 一 定 需 要 知道 其 托管 activity 的 细节 
问题 ， 至 少 在 需要 保持 fragment 通 用 独立 的 时 候 如 此 。 








10.2.2 ”获取 argument 


fragment 需 要 获取 它 的 argument 时 ， 会 先 调用 Fragment 类 的 getArguments () 方 法 ， 再 调用 
Bundle 限 定 类 型 的 get 方 法 ， 如 getSerializable(...) 方 法 。 

现在 回 到 CrimeFragment .onCreate(...) 方 法 中 ， 改 为 从 fragment 的 areument 中 获取 UUID， 
如 代码 清单 10-8 所 示 。 


代码 清单 10-8 从 argument 中 获取 crime ID ( CrimeFragment.java ) 


@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


UUID crimeId = (UUID) getActivity().getIntent(} 

















“getSerializableExtra(CrimeActivity.EXTRA_CRIME_ID); 
UUID crimeId = (UUID) getArguments().getSerializable(ARG_ CRIME_ID); 
mCrime = CrimeLab.get(getActivity()).getCrime(crimeld); 


} 
运行 CriminalIntent 应 用 。 虽 然 运行 结果 一 样 ， 但 有 理由 高 兴 高 兴 ， 因 为 我 们 不 仅 让 
crimeFragment 类 变 得 通用 了 ， 还 为 下 一 章 实 现 更 为 复杂 的 列表 项 导航 打下 了 良好 基础 。 


10.3 ”刷新 显示 列表 项 


运行 CriminalIntent 应 用 ， 点 击 某 个 列表 项 ， 然 后 修改 对 应 的 Crime 明 细 人 信息。 这些 修 改 数据 
已 保存 至 模型 层 ， 但 返回 列表 后 ，RecyclerView 视 图 并 没有 刷新 。 下 面 就 来 处 理 这 个 问题 。 

模型 层 保存 的 数据 若 有 变化 (或 可 能 有 变 )， 应 通知 RecyclerView 的 Adapter， 以 便 其 及 时 
获取 最 新 数据 并 刷新 显示 列表 项 。 在 恰当 的 时 机 ， 与 系统 的 ActivityManager 回 退 栈 协同 运作 ， 
可 实现 列表 项 的 刷新 。 

CrimeListFragment 启 动 CrimeActivity 实 例 后 , CrimeActivity 被 置 于 回 退 栈 顶 。 这 导致 
原先 处 于 栈 顶 的 CrimeListActivity 实 例 被 暂停 并 停止 。 
用 户 点 击 后 退 键 返回 到 列表 项 界面 , CrimeActivity 随 即 弹 出 栈 外 并 被 销毁 。 此 时 ,Crime- 
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ListActivity 立 即 重新 启动 并 恢复 运行 。 应 用 的 回 退 栈 如 图 10-4 所 示 。 
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图 10-4 ”CriminalIntent 应 用 的 回 退 栈 








CrimeListActivity 恢 复 运 行 后 ， 操 作 系 统 会 发 出 调用 onResume() 生 命 周 期 方法 的 指令 。 
CrimeListActivity 接 到 指令 后 ， 它 的 FragmentManager 会 调用 当前 被 activity 托 管 的 fragment 
的 onResume() 方 法 。 这 里 的 fragment 就 是 指 CrimeListFragment。 

在 CrimeListFragment 中 , 覆盖 onResume ( ) 方 法 , 触发 调用 updateUI() 方 法 刷新 显示 列表 
项 ， 如 代码 清单 10-9 所 示 。 如 果 已 配置 好 CrimeAdapter， 就 调用 notifyDataSetChanged () 方 
法 来 修改 updateUI() 方 法 。 


代码 清单 10-9 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


























在 onResume ( ) 方 法 中 刷新 列表 项 ( CrimeListFragment.java ) 


Goverride 

public void onResume() { 
super.onResume(); 
updateUI( ) ; 

} 


private void updateUI() { 
CrimeLab crimeLab = CrimeLab.get(getActivity()); 
List<Crime> crimes = crimeLab.getCrimes(); 


if (mAdapter == nuLL) { 
mAdapter = new CrimeAdapter(crimes); 
mCrimeRecyclerView.setAdapter(mAdapter); 
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} eLse { 
mAdapter.notifyDataSetChanged() ; 
} 
} 


为 什么 选择 覆盖 onResume ( ) 方 法 来 刷新 显示 列表 项 ， 而 不 用 onSstart () 方 法 呢 ? 当 有 其 他 
activity 位 于 你 的 activity 之 前 时 ， 你 无 法 确定 自己 的 activity 是 否 会 被 停止 。 如 果 前 面 的 activity 是 透 
明 的 ,你 的 activity 可 能 会 被 暂停 。 对 于 此 场景 下 暂停 的 activity，onStart() 方 法 中 的 更 新 代码 是 
不 会 起 作用 的 。 一 般 来 说 ,要 保证 fragment 视 图 得 到 刷新 ， 在 onResume() 方 法 内 更 新 代码 是 最 安 
全 的 选择 。 

运行 CriminalIntent 应 用 。 选 择 某 个 crime 项 并 修改 其 明细 内 容 , 然后 返回 到 列表 项 界面 。 可 以 
看 到 ， 列 表 项 已 经 刷新 。 

经 过 前 两 章 的 开发 ，CriminalIntent 应 用 已 获得 大 幅 改 进 。 现 在 ， 再 来 看 看 升级 后 的 应 用 对 象 
图 解 ， 如 图 10-5 所 示 。 
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图 10-5 ”应 用 对 象 图 解 更 新 版 





10.4 ”通过 fragment 获取 返回 结果 


如 需 从 已 启动 的 activity 获 取 返 回 结 果 ， 可 使 用 与 GeoQuiz 应 用 中 类 似 的 实现 代码 。 具 体 的 代 
人 码 调整 就 是 : 不 调用 Activity 的 startActivityForResult(...,) 方 法 ， 转 而 调用 Fragment. 
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startActivityForResult(...) 方 法 ; 不 窗 亲 Activity.onActivityResult(...) 方 法 ， 转 而 履 
羔 Fragment.onActivityResult(...) 方 法 。 


public class CrimeListFragment extends Fragment { 
private static final int REQUEST CRIME = 1; 


private class CrimeHolder extends RecyclerView.ViewHolder 
implements View.OnClickListener { 
@Override 
public void onClick(View view) { 


Intent intent = CrimeActivity.newIntent(getActivity(), mCrime.getId()); 
startActivityForResult(intent, REQUEST CRIME); 


} 


@Override 
public void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (requestCode == REQUEST CRIME) { 
// Handle result 
3 


} 

除 将 返回 结果 从 托管 activity 传 递 给 fragment 的 额外 实现 代码 之 外 , Fragment .startActivity- 
ForResult (Intent,int) 方 法 类 似 于 Activity 的 同名 方法 。 

从 fragment 中 返回 结果 的 处 理 稍 有 不 同 。 fragment 能 够 从 activity 中 接收 返回 结果 , 但 其 自身 无 
法 持 有 返回 结果 。 只 有 activity 拥 有 返回 结果 。 因 此 ， 尽 管 Fragment 有 自己 的 startActivityFor- 
Result(...) 方 法 和 onActivityResult(.,..) 方 法 , 但 没有 setResult(...) 方 法 。 

相反 ， ， 应 让 托管 activity 返 回 结果 值 ， 具体 代码 如 下 。 


public class CrimeFragment extends Fragment { 



































public void returnResult() { 
getActivity().setResult(Activity.RESULT OK, null); 
} 


10.5 深入 学 习 : 为 何 要 用 fragment argument 


fragment argument 的 使 用 有 点 复杂 ,为 什么 不 直接 在 CrimeFragment 里 创建 一 个 实例 变量 呢 ? 
创建 实例 变量 的 方式 并 不 可 靠 。 这 是 因为 , 在 操作 系统 重建 fragment 时 ( 设备 配置 发 后 改变 ) 
用 户 暂 时 离开 当前 应 用 (操作 系统 按 需 回收 内 存 )， 任 何 实例 变量 都 将 不 复 存在 。 尤 其 是 内 存 不 
够 ， 操 作 系统 强制 杀 掉 应 用 的 情况 ， 可 以 说 是 无 人 能 挡 。 

因此 ， 可 以 说 ，fragment argument 就 是 为 应 对 上 述 场景 而 生 。 
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还 有 另 一 个 方法 应 对 上 述 场景 ， 那 就 是 使 用 实例 状态 保存 机 制 。 具 体 来 说 ， 就 是 将 crime ID 
赋值 给 实例 变量 ， 然 后 在 onSaveInstanceState(BundtLe) 方 法 中 保存 下 来 。 要 用 时 ， 从 
onCreate(Bundte) 方 法 中 的 Bundte 中 取 回 。 

然而 ， 这 种 解决 方案 的 维护 成 本 高 。 举 例 来 说 ， 如 果 你 在 否 干 年 后 要 修改 fragment 代 码 以 添 
加 其 他 argument， 很 可 能 会 忘记 在 onSaveInstanceState(Bundle) 方 法 里 保存 新 增 的 argument。 

Android 开 发 人 员 更 喜欢 fragment argument 这 个 解决 方案 ， 因 为 这 种 方式 很 清楚 直 白 。 若 干 年 
后 ， 再 回头 修改 老 代 码 时 ， 一 眼 就 能 知道 ，crime ID 是 以 argument 保 存 和 传递 使 用 的 。 即 使 要 新 
增 argument， 也 会 记得 使 用 argument bundle 保 存 它 。 























10.6 ”挑战 练习 : 实现 高 效 的 RecyclerView 刷新 


Adapter 的 notifyDataSetChanged 方 法 会 通知 RecyclerView 刷 新 全 部 的 可 见 列表 项 。 

在 CriminalIntent 应 用 里 ， 这 个 方法 不 够 高 效 。 这 是 因为 ， 返 回 CrimeListFragment 时 ， 最 多 
只 有 一 个 Crime 实 例会 发 生变 化 。 

只 需要 刷新 列表 项 中 的 单个 crime 项 的 话 ， 应 该 使 用 RecyclerView.Adapter 的 notifyItem- 
Changed (int) 方 法 。 修改 代码 调用 这 个 方法 很 简单 , 但 如 何 定位 并 刷新 具体 位 置 的 列表 项 呢 ? 这 
是 一 个 挑战 ! 


10.7 ”挑战 练习 : 优化 CrimeLab 的 表现 


CrimeLab 的 getCrime (UUID) 方 法 没 毛病 ,但 匹配 要 找 的 crime ID 这 个 过 程 还 可 以 再 优化 。 
请 优化 匹配 逻辑 ， 不 过 重 构 代码 时 ， 不 要 搞 坏 了 CriminalIntent 应 用 。 

















使 用 ViewPager 








本 章 , 我 们 将 创建 一 个 新 的 activity， 用 来 托管 CrimeFragment。 新 建 activity 的 布局 将 由 一 个 
ViewPager 实 例 组 成 。 为 UI 添加 ViewPager 后 ， 用户 可 左右 滑动 屏幕 ,切换 查看 不 同 列 表 项 的 明 
细 页 面 ， 如 图 11-1 所 示 。 


























Solved 











向 左 滑 











4 Le 口 














图 11-1 滑 屏 切换 显示 Crime 明 细 内 容 


11-2 为 升级 后 的 CriminalIntent 应 用 对 象 图 解 。 可 以 看 到 ， 名 为 CrimePagerActivity 的 新 
建 activity 取 代 了 CrimeActivity。 其 布局 由 一 个 ViewPager 组 成 。 

如 图 11-2 所 示 ， 无 需 改 变 CriminalIntent 应 用 的 其 他 部 分 ， 我 们 只 要 创建 虚线 框 中 的 对 象 就 能 
实现 滑 屏 切换 Crime 明 细 页 面 。 特 别 要 说 的 是 ， 经 过 上 一 章 的 封装 ，CrimeFragment 类 有 既 通 用 又 
独立 ， 因 此 这 里 就 不 用 管 它 了 。 

接 下 来 ,我们 需要 完成 以 下 任务 : 

口 创建 CrimePagerActivity 类 ; 
口 定义 包含 ViewPager 的 视图 层级 结构 ; 
口 在 CrimePagerActivity 类 中 关联 使 用 ViewPager 及 其 Adapter; 
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口 修改 CrimeHolder.onClick(...) 方 法 ， 转 而 启动 CrimePagerActivity。 
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图 11-2 CrimePagerActivity 的 对 象 图 解 


11.1 创建 CrimePagerActivity 

















CrimePagerActivity 是 AppCompatActivity 的 子 类 。 在 CriminalIntent 应 用 中 ， 其 任务 是 创 
建 并 管理 ViewPager。 

以 AppCompatActivity 为 超 类 , 创建 CrimePagerActivity 新 类 并 为 其 配置 视图 , 如 代码 清 
单 11-1 所 示 。 











代码 清单 11-1 创建 ViewPager ( CrimePagerActivity.java ) 
public class CrimePagerActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity crime pager); 


} 


参照 图 11-3， 以 ViewPager 为 根 视图 ， 在 res/layout/ 目 录 下 创建 名 为 activity_crime_pager 的 布 
局 文件 。 注 意 ， 必 须 使 用 ViewPager 的 完整 包 名 ( android.support.v4.view.ViewPager )。 
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android.support.v4.view.ViewPager 
xmlns:android="http://schemas.android.com/apk/res/android" 


android:id="@+id/activity_crime_pager_view_pager" 


android: layout_width="match_parent" 
android: layout_height="match_parent" 








图 11-3 CrimePagerActivity 的 ViewPager 布 局 (activity_crime pager.xml ) 


因为 ViewPager 类 来 自 于 支持 库 ， 所 以 添加 到 布局 时 包 和 名 要 完整 。 与 Fragment 类 不 同 ， 
ViewPager 仅 存在 于 支持 库 。 而 且 ， 在 SDK 的 后 续 版 本 中 ，Google 也 没有 在 标准 库 中 实现 


ViewPager 类 。 














11.1.1 ViewPager 与 PagerAdapter 


ViewPager 在 某 种 程度 上 类 似 于 RecyclerView。 RecyclerView 需 借助 于 Adapter 提 供 视 图 。 
同样 ，ViewPager 需 要 PagerAdapter 的 支持 。 

不 过 ， 相 较 于 RecyclerView 与 Adapter 间 的 协同 工作 ，ViewPager 与 PagerAdapter 间 的 配 
合 要 复杂 得 多 。 好 在 Google 提 供 了 PagerAdapter 的 子 类 FragmentStatePagerAdapter, 它 能 协 
助 处 理 许多 细节 问题 。 

FragmentStatePagerAdapter 化 繁 为 简 ， 提 供 了 两 个 有 用 的 方法 : getCount() 和 getItenm 
(int) 。 调 用 getItem(int) 方 法 ， 获 取 并 显示 crime 数 组 中 指定 位 置 的 Crime 时 ， 它 会 返回 配置 
过 的 CrimeFragment 来 显示 指定 的 Crime。 

在 CrimePagerActivity 中 ， 设 置 ViewPager 的 pager adapter， 并 实现 它 的 getCount ( ) 方 法 
和 getItem(int) 方 法 ， 如 代码 清单 11-2 所 示 。 























代码 清单 11-2 设置 pager adapter (CrimePagerActivity.java) 
public class CrimePagerActivity extends AppCompatActivity { 


private ViewPager mViewPager; 
private List<Crime> mCrimes; 


@Override 

protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity crime pager); 


mViewPager = (ViewPager) findViewById(R.id.crime view pager); 


mCrimes = CrimeLab.get(this) .getCrimes(); 
FragmentManager fragmentManager = getSupportFragmentManager(); 
mViewPager .setAdapter (new FragmentStatePagerAdapter(fragmentManager) { 


@Override 
public Fragment getItem(int position) { 
Crime crime = mCrimes.get(position); 
return CrimeFragment.newInstance(crime.getId()); 
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@Override 
public int getCount() { 


}); 


return mCrimes.size(); 


下 面 来 逐 行 解读 新 增 代码 。 在 activity 视 图 中 找到 ViewPager 后 ,我 们 从 CrimeLab 中 (crime 





的 List ) 获取 数据 集 ， 


然后 获取 activity 的 FragmentManager 实 例 。 





接 下 来 ， 设 置 adapter 为 FragmentStatePagerAdapter 的 一 个 匿名 实例 。 创 建 Fragment - 
StatePagerAdapter 实 例 需 要 FragmentManager。 如 前 所 述 ，FragmentStatePagerAdapter 是 


我 们 的 代理 ， 负 责 管 





理 与 ViewPager 的 对 话 并 协同 工作 。 ee int) 方 法 返回 




















的 ffagment 添 加 给 activity ， 然 后 才能 使 用 fragment 完 成 自己 的 工作 。 这 也 就 是 创建 代理 实例 时 ， 


需要 FragmentManager 的 原因 。 
































(代理 究竟 做 了 哪些 工作 呢 ? 简单 来 说 ， 就 是 将 返回 的 ffagment 添 加 给 托管 activity ， 并 帮助 
ViewPager 找 到 fragment 的 视图 并 一 一 对 应 ， 详 见 11.3 节 。) 

pager adapter 的 两 个 方法 简单 直接 。getCount() 方 法 返回 数组 列表 中 包含 的 列表 项 数目 。 
getItem(int) 方 法 才 是 神奇 所 在 。 它 首先 获取 数据 集中 指定 位 置 的 Crime 实 例 ， 然 后 利用 该 
crime 实例 的 ID 创建 并 返回 一 个 经 过 有 效 配置 的 CrimeFragment。 














11.1.2 ”整合 并 配置 使 用 CrimePagerActivity 


现在 ， 弃 用 CrimeActivity， 我 们 来 配置 使 用 CrimePagerActivity。 
首先 新 增 newIntent 方 法 和 crime ID 的 extra 常 量 ， 如 代码 清单 11-3 所 示 。 











代码 清单 11-3 ”创建 newIntent 方 法 (CrimePagerActivityjava ) 


public class CrimePagerActivity extends AppCompatActivity { 
private static final String EXTRA CRIME ID = 
"com.bignerdranch.android.criminalintent.crime id"; 


private ViewPager mViewPager; 
private List<Crime> mCrimes; 


public static Intent newIntent(Context packageContext, UUID crimeId) { 
Intent intent = new Intent(packageContext, CrimePagerActivity.class); 
intent.putExtra(EXTRA CRIME ID, crimeld); 
return intent; 


} 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity crime pager); 
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UUID crimeId = (UUID) getIntent() 
.getSeriaLizabLeExtra(EXTRA_CRIME_ID); 


} 

然后 需要 修改 CrimeListFragment， 使 得 用 户 单 击 某 个 列表 项 时 ，CrimeListFragment 启 
动 的 是 CrimePagerActivity 实 例 。 

回 到 CrimeListFragment.java 文 件 ， 修 改 CrimeHolder.onClick(View) 方 法 以 启动 Crime- 
PagerActivity， 如 代码 清单 11-4 所 示 。 








代码 清单 11-4 配置 启动 CrimePagerActivity ( CrimeListFragment.java ) 
private class CrimeHolder extends RecyclerView.ViewHolder 
implements View.OnClickListener { 
@Override 
public void onClick(View view) { 


Intent intent = CrimePagerActivity.newIntent(getActivity(), mCrime.getId()); 
startActivity(intent); 


} 

最 后 , 要 让 操作 系统 启动 CrimePagerActivity, 还 要 在 manifest 配 置 文 件 中 添加 它 ， 如 代码 
清单 11-5 所 示 。 打 开 AndroidManifest.xml， 添 加 CrimePagerActivity 声 明 ， 同 时 删除 不 再 使 用 
的 CrimeActivity 声 明 ; 也 可 以 直接 将 CrimeActivity 重 命名 为 CrimePagerActivity。 











代码 清单 11-5 ”添加 CrimePagerActivity 到 manifest 配 置 文件 ( AndroidManifest.xml ) 


<manifest ...> 
<application ...> 


<activity 
android:name=" .CrimeActivity" 
android:name=" .CrimePagerActivity"> 
</activity> 


最 后 ， 从 项 目 工 具 窗 口中 删除 CrimeActivity.java 文 件 ， 让 项 目 代 码 更 干净 。 

运行 CriminalIntent 应 用 。 点 击 Crime 加 查看 其 明细 ， 然 后 左右 滑 屏 浏览 其 他 crime 明 细 。 可 以 
看 到 ， 页 面 切换 流畅 ， 数 据 加 载 毫 无 延迟 。ViewPager 默 认 加 载 当 前 屏幕 上 的 列表 项 ， 以 及 左右 
相 邻 页 面 的 数据 ， 因 此 响应 迅速 。 如 果 有 需要 ， 可 以 调用 set0ffscreenPageLimit(int) 方 法 ， 
定制 预 加 载 相 邻 页 面 的 数目 。 

注意 ， 目 前 ViewPager 还 不 够 完美 。 单 击 后 退 键 返 回 列 表 项 界面 ， 再 点 选 其 他 crime 列 表 项 。 
可 以 看 到 屏幕 上 显示 的 仍 是 第 一 个 crime 列 表 项 的 明细 ， 而 非 当前 点 选 的 列表 项 。 

ViewPager 默 认 只 显示 PagerAdapter 中 的 第 一 个 列表 项 。 要 显示 选中 的 列表 项 ， 可 设置 
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ViewPager 当 前 要 显示 的 列表 项 为 crime 数 组 中 指定 位 置 的 列表 项 。 

在 CrimePagerActivity.onCreate(Bundle) 方 法 的 末尾 ,循环 检查 crime 的 ID， 找 到 所 选 
crime 在 数组 中 的 索引 位 置 。 如 果 Crime 实 例 的 mId 与 intent extra 的 crimeId 相 匹配 , 设置 显示 指定 
位 置 的 列表 项 ， 如 代码 清单 11-6 所 示 。 











Re 





代码 清单 11-6 设置 初始 分 页 显示 项 ( CrimePagerActivity.java ) 
public class CrimePagerActivity extends AppCompatActivity { 
@Override 
protected void onCreate(Bundle savedInstanceState) { 


FragmentManager fragmentManager = getSupportFragmentManager(); 
mViewPager.setAdapter(new FragmentStatePagerAdapter(fragmentManager) { 


}); 
for (int i = 0; i < mCrimes.size(); i++) { 
if (mCrimes.get(i).getId().equals(crimeId)) { 


mViewPager .setCurrentItem(i); 
break; 


} 


运行 CriminalIntent 应 用 。 选 择 任意 列表 项 ， 其 对 应 的 Crime 明 细 应 该 能 够 显示 了 。 现 在 
ViewPager 的 使 用 配置 已 完成 ， 可 以 投入 使 用 了 。 








3 








11.2 FragmentStatePagerAdapter 与 FragmentPagerAdapter 


FragmentPagerAdapter 是 另外 一 种 可 用 的 PagerAdapter， 其 用 法 与 FragmentStatePager- 
Adapter 基 本 一 致 。 唯 一 的 区 别 在 于 , 印 载 不 再 需要 的 fragment 时 , 各 自 采用 的 处 理 方法 有 所 不 同 。 

FragmentStatePagerAdapter 会 销毁 不 需要 的 fragment。 事 务 提 交 后 ，activity 的 Fragment - 
Manager 中 的 fragment 会 被 彻底 移 除 。FragmentStatePagerAdapter 类 名 中 的 “state” 表 明 : 在 
销毁 fragment 时 , 可 在 onSaveInstanceState(Bundte) 方 法 中 保存 fragment 的 BundtLe 信 息 。 用 户 
切换 回来 时 ， 保 存 的 实例 状态 可 用 来 生成 新 的 fragment ( 如 图 11-4 所 示 )。 

相 比 之 下 ，FragmentPagerAdapter 有 不 同 的 做 法 。 对 于 不 再 需要 的 ffagment，Fragment - 
PagerAdapter 会 选择 调用 事务 的 detach (Fragment) 方 法 来 处 理 它 , 而 非 remove (Fragment) 方 
法 。 也 就 是 说 ，FragmentPagerAdapter 只 是 销毁 了 而 fragment 的 视图 ， 而 fragment 实 例 还 保留 在 
FragmentManager 中 。 因 此 , FragmentPagerAdapter 创 建 的 fragment 永远 不 会 被 销毁 ( 如 图 11-5 
所 示 )。 
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FragmentState 
PagerAdapter 
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图 11-4 ”FragmentStatePagerAdapter 的 fragment 管 理 
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图 11-5 ”FragmentPagerAdapter 的 fragment 管 理 





选择 哪 种 adapter 取 决 于 应 用 的 要 求 。 通 常 来 说 ， 使 用 FragmentStatePagerAdapter 更 节省 
内 存 。CriminalIntent 应 用 需 显 示 大 量 crime 记 录 , 每 份 记录 最 终 还 会 包含 图 片 。 在 内 存 中 保存 所 有 
言 息 显 然 不 合适 ， 因 此 我 们 选择 使 用 FragmentStatePagerAdapter。 
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另 一 方面 ， 如 果 用 户 界 面 只 需要 少量 固定 的 fragment， 则 FragmentPagerAdapter 是 安全 、 
合适 的 选择 。 最 常见 的 例子 为 使 用 tab 选 项 页 显示 用 户 界面 。 例 如 ， 某 些 应 用 的 明细 视图 所 含 内 
容 较 多 , 通常 需 分 两 页 显示 。 这 时 就 可 以 将 这 些 明 细 信 息 分 拆 开 来 , 以 多 页 面 的 形式 展现 。 显然 ， 
为 用 户 界面 添加 支持 滑动 切换 的 ViewPager， 能 增强 应 用 的 触摸 体验 。 此 外 ， 将 fragment 保 存在 
内 存 中 ， 更 易于 管理 控制 器 层 的 代码 。 对 于 这 种 类 型 的 用 户 界 面 ， 每 个 activity 通 常 只 有 两 三 个 
fragment， 基 本 不 用 担心 有 内 存 不 足 的 风险 。 


11.3 ”深入 学 习 : ViewPager 的 工作 原理 


ViewPager 和 PagerAdapter 在 后 台 为 我 们 完成 了 很 多 工作 。 本 节 我 们 来 深入 学 习 ViewPager 
的 工作 原理 。 

继续 之 前 ， 先 提 个 醒 : 大 多 数 情 况 下 ， 我 们 无 需 了 解 其 内 部 实现 细节 。 

不 过 , 如 果 要 自己 实现 PagerAdapter 接 口 , 则 需 了 解 ViewPager-PagerAdapter 和 Recycler- 
View-Adapter 各 自 关系 的 异同 。 

什么 时 候 需 要 自己 实现 PagerAdapter 接 口 呢 ?需要 ViewPager 托 管 非 fragment 视 图 时 ( 如 图 
片 这 样 的 常见 View 对 和 象 )， 就 需要 实现 原生 PagerAdapter 接 口 。 

为 什么 选择 使 用 ViewPager 而 不 是 RecyclerView 呢 ? 

由 于 无 法 使 用 现 有 的 Fragment， 因 此 在 CriminalIntent 应 用 中 使 用 RecyclerView 需 处 理 大 量 
内 部 实现 工作 。Adapter 需 要 我 们 及 时 地 提供 View。 然 而 ， 决 定 fragment 视 图 何 时 创建 的 是 
FragmentManager。 因 此 ， 当 RecyclerView 要 求 Adapter 提 供 fragment 视 图 时 , 我们 无 法 立即 创 
建 fragment 并 提供 其 视图 。 

这 就 是 ViewPager 存 在 的 理由 。 它 使 用 的 是 PagerAdapter 类 ， 而 非 原来 的 Adapter。 
PagerAdapter 要 比 Adapter 复 杂 得 多 ， 因 为 它 要 人 处理 更 多 的 视图 管理 工作 。 以 下 为 它 的 内 部 
实现 。 

PagerAdapter 不 使 用 可 返回 视图 的 onBindViewHolder(... ) 方 法 ,而 是 使 用 下 列 方法 : 


public Object instantiateItem(ViewGroup container, int position) 
public void destroyItem(ViewGroup container, int position, Object object) 
public abstract boolean isViewFromObject(View view, Object object) 






















































































PagerAdapter.instantiateItem(ViewGroup，int) 方 法 告诉 pager adapter 创 建 指定 位 置 
的 列表 项 视图 ， 然 后 将 其 添加 给 ViewGroup 视 图 容 需 ， 而 destroyItem(ViewGroup， int， 
0bject ) 方 法 则 告诉 pager adapter 销 毁 已 建 视图 。 注 意 ，instantiateItem(ViewGroup，int) 
方法 并 不 要 求 立即 创建 视图 。 因 此 ，PagerAdapter 可 自行 决定 何 时 创建 视图 。 

视图 创建 完成 后 , ViewPager 会 在 某 个 时 间 点 看 到 它 。 为 确定 该 视图 所 属 的 对 象 , ViewPager 
会 调用 isViewFrom0bject(View，0bject) 方 法 。 这 里 ，0bject 参 数 是 instantiateItem 
(ViewGroup,int) 方 法 返回 的 对 象 。 因 此 , 假设 ViewPager 调 用 instantiateItem(ViewGroup, 5) 
方法 返回 A 对 象 ， 那 么 只 要 传人 的 View 参 数 是 第 5 个 对 象 的 视图 ，isViewFrom0bject (View，A) 
方法 就 应 返回 true 值 ， 否 则 返回 false 值 。 
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对 于 ViewPager 来 说 ， 这 是 一 个 复杂 的 过 程 ， 但 对 于 PagerAdapter 来 说 ， 这 算 不 上 什么 ， 
因为 PagerAdapter 只 要 能 够 创建 、 销 毁 视 图 以 及 识别 视图 来 自 哪个 对 象 即 可 。 这 样 的 要 求 显 然 
很 宽松 ， 因 而 PagerAdapter 能 够 比较 自由 地 通过 instantiateItem(ViewGroup，int) 方 法 创 
建 并 添加 新 的 fragment, 然后 返回 可 以 跟踪 管理 的 0bject( fragment ), 以 下 为 isViewFrom0bject 
(View，0bject) 方 法 的 具体 实现 : 






































@Override 

public boolean isViewFromObject(View view, Object object) { 
return ((Fragment)object).getView() == view; 

E 








可 以 看 到 ， 每 次 需要 使 用 ViewPager 时 ， 都 要 覆盖 实现 PagerAdapter 的 这 些 方法 ， 这 真是 
一 种 磨难 。 幸 好 ， 还 有 FragmentPagerAdapter 和 FragmentStatePagerAdapter。 真 心 感谢 它们 ! 


11.4 深入 学 习 : 以 代码 的 方式 创建 视图 


本 书 一 直通 过 布局 文件 创建 视图 ， 其 实 也 可 以 在 代码 里 创建 视图 。 
实际 上 ， 完 全 可 以 不 用 创建 布局 文件 ， 而 使 用 以 下 代码 定义 ViewPager。 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
ViewPager viewPager = new ViewPager(this); 
setContentView(viewPager); 














} 

以 代码 的 方式 创建 视图 很 简单 : 调用 视图 类 的 构造 方法 ,并 传人 Context 参 数 。 不 创建 任何 
布局 文件 ， 用 代码 就 能 创建 完整 的 视图 层级 结构 。 

但 最 好 不 要 这 样 做 ， 下 面 就 来 谈 谈 使 用 布局 文件 的 好 处 。 

布局 文件 能 很 好 地 分 离 控制 器 层 和 视图 层 对 象 : 视图 定义 在 XML 布局 文件 中 ， 控 制 锅 层 对 
象 定义 在 Java 代 码 中 。 这 样 ， 假 设 控 制 顺 层 有 代码 修改 的 话 ， 代 码 变更 管理 相对 容易 很 多 ; 反之 

另外 ， 使 用 布局 文件 ， 我 们 还 能 使 用 Android 的 资源 适 配 系统 ， 实 现 按 设 备 属性 自动 调用 合 
适 的 布局 文件 〈 如 第 3 章 中 横 屏 模式 的 布局 文件 )。 

当然 , 布局 文件 也 不 是 毫 无 缺点 。 如 果 应 用 只 需 一 个 视图 , 估计 没 人 愿意 麻烦 地 创建 并 实例 
化 布局 XML 文 件 。 

除 此 之 外 ,创建 布 局 文件 的 缺点 都 不 值得 一 提 。 要 知道 ，Android 开 发 团队 从 没 提倡 过 以 代 
码 的 方式 创建 视图 ， 即 便 是 在 因 设 备 配 置 低 、 开 发 人 员 绞 尽 脑 汁 地 提高 应 用 性 能 的 年 代 。 因 此 ， 
使 用 布局 文件 吧 ， 哪 怕 只 是 添加 一 个 小 小 的 视图 ID 也 会 更 加 简单 ! 


11.5 ”挑战 练习 :; 恢复 CrimeFragment 的 边 距 


可 能 你 已 经 注意 到 了 ，CrimeFragment 的 边 距 没有 了 。 奇 怪 啊 ， 在 fragment_crime.xml 文 件 
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里 ,明明 已 指定 过 16dp 的 边 趾 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout margin="16dp" 
android:orientation="vertical"> 


发 生 了 什么 ? 原来, ViewPager 的 布局 参数 是 不 支持 边 距 设 置 的 。 请 修改 fragment_crime.xml 
布局 文件 ， 让 边 距 能 够 显示 出 来 。 


11.6 ”挑战 练习 : 添加 Jump to First 按钮 和 Jump to Last 按钮 


给 CrimePagerActivity 添 加 两 个 按钮 。 允 许 使 用 它们 快速 跳 至 第 一 条 和 最 后 一 条 crime 记 
录 。 当 然 , 要 注意 控制 , 查看 第 一 条 记录 时 应 禁用 Jump to First 按 钮 ,查看 最 后 一 条 时 禁用 Jump to 
Last 按 钮 。 




















对 话 框 














对 话 框 既 能 引起 用 户 的 注意 也 可 接收 用 户 的 输入 。 在 提示 重要 信息 或 提供 用 户 选 项 方面 , 它 
都 非常 有 用 。 本 章 ， 我 们 为 Criminal Intent 应 用 添加 对 话 框 ， 以 便 用 户 修改 crime 记 录 日 期 。 用 户 
点 击 CrimeFragment 中 的 日 期 按钮 时 , 应 用 会 弹出 对 话 框 (Lollipop 及 以 上 版 本 ), 如 图 12-1 所 示 。 





Date of crime: 


2016 


We 本 Ne 


November 2016 














图 12-1 ”可 选择 crime 日 期 的 对 话 刷 


图 12-1 中 的 对 话 框 是 AlertDialog 类 的 一 个 实例 。AlertDialog 类 是 常用 的 多 用 途 Dialog 
子 类 。 

Google 针 对 Lollipop 系 统 重 新 设计 了 对 话 框 。 相 比 旧 系统 版 本 的 对 话 框 (参见 图 12-2 左 侧 )， 
新 版 对 话 框 界面 看 起 来 漂亮 多 了 。 


Iml 
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Report Crime Report Crime 





Are you sure you want to report this 


Are you sure you want to report crime to HR? 


this crime to HR? 


CANCEL REPORT 
Cancel Report 











图 12-2” 旧 系统 ( 左 ) 与 新 系统 的 对 话 框 界面 对 比 


如 果 所 有 Android 用 户 都 能 用 上 新 式 对 话 框 该 多 好 ! Google 也 是 这 么 想 的 ， 因 而 提供 了 
AppCompat 库 版 ALertDialog 类 。 这 个 类 和 操作 系统 内 置 版 ALertDialog 类 似 , 能 兼容 旧版 本 系 
统 。 要 使 用 它 ， 你 需要 引入 android.support.v7.app.AlertDialog 依 赖 项 。 





12.1 创建 DialogFragment 





建议 将 AlertDialog 封 装 在 DialogFragment (Fragment 的 子 类 ) 实例 中 使 用 。 当 然 , 不 使 
用 DialogFragment 也 可 显示 AlertDialog 视 图 ， 但 不 推荐 这 样 做 。 使 用 FragmentManager 管 理 
对 话 框 ， 可 以 更 灵活 地 显示 对 话 框 。 

另外 , 如 果 旋 转 设 备 , 单独 使 用 的 ALertDiatLog 会 消失 , 而 封装 在 fragment 中 的 AlertDialog 
则 不 会 有 此 问题 (旋转 后 ， 对 话 框 会 被 重建 恢复 )。 

就 CriminalIntent 应 用 来 说 ， 我 们 首先 会 创建 名 为 DatePickerFragment 的 DialogFragment 子 
类 。 然 后 ， 在 DatePickerFragment 中 ,创建 并 配置 显示 DatePicker 组 件 的 AlLertDialog 实 例 。 
DatePickerFragment 同 样 由 CrimePagerActivity 托 管 。 

12-3 展 示 了 以 上 各 对 象 间 的 关系 。 
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模型 





mlsSolved 


控制 器 








网 12-3 





CrimePagerActivity 







mCrime 


CrimeFragment DatePickerFragment 





AlertDialog 
CheckBox DatePicker 








由 CrimePagerActivity 托 管 的 两 个 fragment 对 象 





要 显示 对 话 框 ， 首 先 应 完成 以 下 任务 : 


口 创建 AlertDialog; 








稍 后 ， 我 们 还 将 配置 使 月 


口 创建 DatePickerFragment 类 ; 





口 借助 FragmentManager 在 屏幕 上 显示 对 话 框 。 








间 传 递 数据 。 


月 DatePicker， 并 实现 在 CrimeFragment 和 DatePickerFragment 之 


继续 学 习 之 前 ， 请 参照 代码 清单 12-1 添 加 字符 串 资源 备用 。 
代码 清单 12-1 为 对 话 框 标题 添加 字符 串 资 源 〈values/strings.xml ) 


<resources> 


<string name="crime solved label">Solved</string> 
<string name="date picker title">Date of crime:</string> 


</resources> 


创建 DatePickerFragment 新 类 ， 并 设置 其 DialogFragment 超 类 为 支持 库 中 的 android. 
support.v4.app.DialogFragment 类 。 
DialogFragment 类 有 如 下 方法 : 
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public Dialog onCreateDialog(Bundle savedInstanceState) 


为 了 在 屏幕 上 显示 DialogFragment， 托 管 activity 的 FragmentManager 会 调用 它 。 











在 DatePickerFragment.java 中 ， 添 加 onCreateDialog (Bundle) 方 法 的 实现 代码 ， 创 建 一 个 带 
标题 栏 和 OK 按钮 的 ALertDiaLog， 如 代码 清单 12-2 所 示 。( DatePicker 组 件 稍 后 添加 。) 

















导入 AlertDialog 时 ,请 确认 选择 的 是 AppCompat 库 中 的 版 本 : android.support.v7.app. 
AlertDialog。 





代码 清单 12-2 创建 DialogFragment ( DatePickerFragment.java ) 


public class DatePickerFragment extends DialogFragment { 
@Override 
public Dialog onCreateDialog(Bundle savedInstanceState) { 


} 


return new AlertDialog.Builder(getActivity()) 
.SetTitle(R.string.date picker title) 
.SetPositiveButton(android.R.string.ok, null) 
.Create(); 





以 上 代码 中 ， 我 们 使 用 AlertDialog .Builder 类 ， 以 流 接口 的 方式 创建 了 AlertDialog 实 
例 。 下面 详细 解读 一 下 这 段 代码 。 

首先 ， 将 Context 参 数 传 人 AlertDialog.Builder 类 的 构造 方法 ， 返 回 一 个 AlertDialog. 
Builder 实 例 。 


然后 ， 调 用 以 下 两 个 ALertDiatog .Builder 方 法 ， 配 置 对 话机 





HH 











public AlertDialog.Builder setTitle(int titLeId ) 
public AlertDialog.Builder setPositiveButton(int textId, 
DialogInterface.OnClickListener listener) 


调用 setPositiveButton(..,) 方 法 , 需 传人 两 个 参数 :字符 串 资源 和 实现 DiaLogInterface， 
OnCLickListener 接 口 的 对 象 。 代 码 清 单 12-2 中 传人 的 资源 ID 是 Android 的 OK 常量 ; 至 于 监听 带 参 
数 ， 和 暂时 传人 nutltl 值 。 监 听 器 接口 稍 后 实现 。 

( Android 有 3 种 可 用 于 对 话 框 的 按钮 ，positive 按 钮 、negative 按 钮 以 及 neutral 按 钮 。 用 户 点 击 
positive 按 钮 接受 对 话 框 展现 信息 。 如果 同一 对 话 框 上 放置 有 多 个 按钮 , 按钮 的 类 型 与 命名 决定 着 
它们 在 对 话 框 上 显示 的 位 置 。) 





最 后 ，j 









































周 用 AlertDialog .Builder.create() 方 法 , 返回 配置 完成 的 ALertDiaLog 实 例 , 完 





成 对 话 框 的 创建 。 
使 用 ALertDialog 和 AlertDialog.Builder， 还 可 实现 更 多 个 性 化 的 需求 ， 请 查阅 开发 者 





文档 详细 了 解 。 接 下 来 ， 我 们 学 习 如 何在 屏幕 上 显示 对 话 框 














12.1.1 显示 DialogFragment 








和 其 他 fragment 一 样 ，DialogFragment 实 例 也 是 由 托管 activity 的 FragmentManager 管 理 的 。 
要 将 DialogFragment 添 加 给 FragmentManager 管 理 并 放置 到 屏幕 上 ， 可 调用 fragment 实 例 
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的 以 下 方法 : 


public void show(FragmentManager manager, String tag) 
public void show(FragmentTransaction transaction, String tag) 


String 参 数 可 唯一 识别 FragmentManager 队 列 中 的 DiaLogFragment。 两 个 方法 都 可 以 : 如 
果 传 人 FragmentTransaction 参 数 ， 你 自己 负责 创建 并 提交 事务 ; 如果 传人 FragmentManager 
参数 ， 系 统 会 自动 创建 并 提交 事务 。 

这 里 ， 我 们 选择 传人 FragmentManager 人 参数 。 

在 CrimeFragment 中 , 为 DatePickerFragment 添 加 一 个 tag 常 量 。 然 后 , 在 onCreateView(...) 
方法 中 , 删除 禁用 日 期 按钮 的 代码 。 为 mpateButton 按 钮 添加 0nCLickListener 监 听 器 接口 , 实 
现 点 击 日 期 按钮 展现 DatePickerFragment 界 面 ， 如 代码 清单 12-3 所 示 。 





















































代码 清单 12-3 ”显示 DiatLogFragment ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 


private static final String ARG CRIME ID = "crime id"; 
private static final String DIALOG DATE = "DialogDate"; 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


mDateButton = (Button) v.findViewById(R.id.crime date); 
mDateButton.setText(mCrime.getDate().toString()); 
mDateButton.setEnabted(fatse); 
mDateButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
FragmentManager manager = getFragmentManager(); 
DatePickerFragment dialog = new DatePickerFragment(); 
dialog.show(manager, DIALOG_ DATE); 





} 
}); 


mSolvedCheckBox = (CheckBox) v.findViewById(R.id.crime solved); 
return vi 

} 

运行 CriminalIntent 应 用 。 点 击 日 期 按钮 弹出 对 话 框 ， 如 图 12-4 所 示 。 
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Date of crime: 








图 12-4” 带 标题 和 OK 按钮 的 AlertDialog 


12.1.2 ”设置 对 话 框 的 显示 内 容 


接 下 来 ， 使 用 AlertDialog.Builder 的 setView(...) 方 法 ， 给 ALertDialog 对 话 框 添加 
DatePicker 组 件 : 


public AlertDialog.Builder setView(View view) 


该 方法 配置 对 话 框 ， 实 现在 标题 栏 与 按钮 之 间 显 示 传 人 的 View 对 象 。 

在 项 目 工具 窗口 中 ,以 DatePicker 为 根 元 素 , 创建 名 为 dialog_date.xml 的 布局 文件 。 新 布局 
仅 包 含 一 个 View 对 象 ， 即 我 们 生成 并 传 给 setView(... ) 方 法 的 DatePicker 视 图 。 

参照 图 12-5， 配 置 DatePicker 布 局 。 








DatePicker 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/dialog_date_picker" 


android: layout_width="wrap_content" 


android: layout_height="wrap_content" 





android:calendarViewShown=" false" 





图 12-5 DatePicker 布 局 (layout/dialog date.xml ) 
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在 DatePickerFragment.onCreateDialog(Bundle) 方 法 中 ， 实 例 化 DatePicker 视 图 并 添 
加 给 对 话 框 ， 如 代码 清单 12-4 所 示 。 


代码 清单 12-4 给 ALertDiatog 添 加 DatePicker ( DatePickerFragment.java ) 


Goverride 
public Dialog onCreateDialog(Bundle savedInstanceState) { 
View v = LayoutInflater.from(getActivity()) 
.inflate(R.layout.dialog date, null); 


return new AlertDialog.Builder(getActivity()) 
.SetView(v) 
.SetTitle(R.string.date picker title) 
.SetPositiveButton(android.R.string.ok, null) 
.Create(); 

















运行 CriminalIntent 应 用 。 点 击 日 期 按钮 ， 确 认 能 在 对 话 框 中 显示 DatePicker 视 图 。 如 果 是 
Lollipop 系 统 ， 还 能 看 到 日 历 选 择 界面 ， 如 图 12-6 所 示 。 
图 12-6 所 示 的 日 历 选 择 界面 是 随 material design 引 入 的 。 这 个 版 本 的 DatePicker 组 件 会 忽略 布 
局 中 指定 的 calendarViewShown 属 性 。 如 果 使 用 旧版 本 系统 ，DatePicker 组 件 会 使 用 
calendarViewShown 属 性 ， 因 而 我 们 会 看 到 如 图 12-7 所 示 的 用 户 界面 。 














Date of crime: 


2016 


Mon, Nov 21 


Date of crime: 


November 2016 














图 12-6 Lollipop 系统 中 的 DatePicker 图 12-7 显示 DatePicker 的 AlertDialog 


对 话 框 完 全 兼容 新 旧 系统 ， 不 过 新 系统 版 本 的 界面 显然 更 美观 。 
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采用 以 下 代码 也 能 创建 DatePicker 对 象 ， 为 何 还 要 费 
视图 对 象 呢 ? 
@Override 


public Dialog onCreateDialog(Bundle savedInstanceState) { 
DatePicker datePicker = new DatePicker(getActivity()); 





志 地 定义 XML 布局 文件 ， 再 去 实例 化 


return new AlertDialog.Builder(getActivity()) 
.SetView(datePicker) 
Coate js 
} 
这 是 因为 ， 想 调整 对 话 框 的 显示 内 容 时 ， 直 接 修改 布局 文件 会 更 容易 些 。 例 如 ， 如 果 想 在 对 
话 框 的 DatePicker 旁 再 添加 一 个 TimePicker， 只 需 更 新 布局 文件 就 能 显示 新 视图 。 
即使 设备 旋转 ， 用 户 所 选 日 期 也 都 会 得 到 保留 ， )。 这 是 如 何 做 到 的 呢 ? 前 面 说 过 ， 
设备 配置 改变 时 ， 具 有 了 ZDp 属 性 的 视图 可 以 保存 运行 状态 ; 而 我 们 以 dialog_date.xml 布 局 创建 
DatePicker 时 ， 编译 工具 已 为 Datepicker 生 成 了 唯一 的 ID。 
如 果 以 代码 的 方式 创建 DatePicker， 想 看 到 同样 的 效果 ， 需 要 为 其 设置 DD 属性 。 
至 此 ， 显 示 对 话 框 的 工作 就 完成 了 。 下 _- 节 ， 我 们 实现 显示 Crime 日 期 ， 并 支持 用 户 对 其 
行 修改 。 


12.2 _ fragment 间 的 数据 传递 


前 面 ， 我 们 实现 了 activity 之 间 以 及 基于 fragment 的 activity 之 间 的 数据 传递 。 现 在 需 实现 同一 
activity 托 管 的 两 个 fragment 之 间 的 数据 传递 (CrimeFragment 和 DatePickerFragment )， 如 
12-8 所 示 。 

















































































































显示 的 日 期 


CrimeFragment 





DatePickerFragment 





用 户 所 选 日 期 


图 12-8 CrimeFragment 与 DatePickerFragment 间 的 对 话 


要 传递 crime 的 日 期 给 DatePickerFragment ， 需 新 建 一 个 newInstance(Date) 方 法 ， 然 后 
将 Date 作 为 argument 附 加 给 fragment。 

为 返回 新 日 期 给 CrimeFragment, 并 更 新 模型 层 以 及 对 应 视图 , 需 将 日 期 打包 为 extra 并 附加 
到 Intent 上 ,然后 调用 CrimeFragment .onActivityResult(...) 方 法 ,并 传 入 准备 好 的 Intent 
参数 ， 如 图 12-9 所 示 。 














12.2 fragment 间 的 数据 传递 197 





CrimeFragment 


mcCrime.getDate() 


1 
1 
1 
1 
| newlnstance(Date) 
1 
1 
1 
1 
1 


DatePickerFragment 


1 
1 
mCrime.setDate(...) | 
| 
1 


了 V 





图 12-9 CrimeFragment 和 DatePickerFragment 间 的 事件 流 


在 稍 后 的 实现 代码 中 可 以 看 到 ， 我 们 没有 调用 托管 activity 的 Activity.onActivityResult 
(...) 方 法 ， 而 是 调用 了 Fragment .onActivityResult(,..) 方 法 ,这 似乎 令 人 费解 。 实 际 上 ， 
调用 onActivityResult(...) 方 法 实现 fragment 间 的 数据 传递 不 仅 行 得 通 , 而且 可 以 更 灵活 地 展 
现 对 话 框 fragment ( 稍 后 会 看 到 )。 





























12.2.1 传递 数据 给 DatePickerFragment 














要 传递 crime 日 期 给 DatePickerFragment ， 需 将 它 保存 在 DatePickerFragment 的 argument 
bundle 中 。 这 样 ，DatePickerFragment 就 能 直接 获取 它 。 

创建 和 设置 fagment argument 通 常 是 在 newInstance() 方 法 中 完成 的 (代替 fragment 构 造 方 
法 )。 在 DatePickerFragment.java 中 ， 添 加 一 个 newInstance(Date) 方 法 ， 如 代码 清单 12-5 所 示 。 














代码 清单 12-5 ”添加 newInstance(Date) 方 法 (DatePickerFragment.java ) 


public class DatePickerFragment extends DialogFragment { 
private static final String ARG DATE = "date"; 
private DatePicker mDatePicker; 


public static DatePickerFragment newInstance(Date date) { 
Bundle args = new Bundle(); 
args.putSerializable(ARG _ DATE, date); 


DatePickerFragment fragment = new DatePickerFragment(); 
fragment.setArguments (args); 
return fragment; 


} 


然后 ， 在 CrimeFragment 中 ， 用 DatePickerFragment.newInstance(Date) 方法 替换 
DatePickerFragment 的 构造 方法 ， 如 代码 清单 12-6 所 示 。 
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代码 清单 12-6 ”添加 newInstance() 方 法 ( CrimeFragment.java ) 


@Override 
public View onCreateView(LayoutInflater inflater,ViewGroup container, 
Bundle savedInstanceState) { 


mDateButton = (Button)v.findViewById(R.id.crime date); 
mDateButton.setText (mCrime.getDate().toString()); 
mDateButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
FragmentManager manager = getFragmentManager() 
DatePickerFragment diatog = new DatePickerFragment(); 
DatePickerFragment dialog = DatePickerFragment 
.newInstance(mCrime.getDate()); 
dialog.show(manager, DIALOG DATE); 





} 
}); 
es 
} 
DatePickerFragment 使 用 Date 中 的 信息 来 初始 化 DatePicker 对 象 。 人 然而，DatePicker 对 
象 的 初始 化 需 整 数 形式 的 月 、 日 、 年 。Date 是 时 间 稚 ,无 法 直接 提供 整数 。 
要 达到 目的 ， 必 须 首先 创建 一 个 Calendar 对 象 ， 然 后 用 Date 对 象 配置 它 ， 再 从 Calendar 对 
象 中 取 回 所 需 信息 。 
在 onCreateDialog(Bundle) 方 法 内 ， 从 argument 中 获取 Date 对 象 ， 然 后 用 它 和 Calendar 
对 象 初始 化 DatePicker， 如 代码 清单 12-7 所 示 。 


代码 清单 12-7 获取 Date 对 象 并 初始 化 DatePicker ( DatePickerFragment.java ) 


@Override 
public Dialog onCreateDialog(Bundle savedInstanceState) { 
Date date = (Date) getArguments().getSerializable(ARG DATE); 
































Calendar calendar = Calendar.getInstance(); 
calendar .setTime (date); 

int year = calendar.get(Calendar .YEAR); 

int month = calendar.get(Calendar.MONTH); 

int day = calendar.get(Calendar.DAY OF_ MONTH); 


View v = LayoutInflater.from(getActivity()) 
.inflate(R.layout.dialog date, null); 


mDatePicker = (DatePicker) v.findViewById(R.id.dialog date picker); 
mDatePicker.init(year, month, day, null1); 


return new AlertDialog.Builder(getActivity()) 
.SetView(v) 
.SetTitle(R.string.date picker title) 
.SetPositiveButton(android.R.string.ok, null) 
.Create(); 
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现在 ,我 们 成 功 完成 了 CrimeFragment 向 DatePickerFragment 传 递 日 期 。 运 行 CriminalIntent 
应 用 ， 看 看 效果 如 何 。 




















12.2.2 ”返回 数据 给 CrimeFragment 


要 让 CrimeFragment 接 收 DatePickerFragment 返 回 的 日 期 数据 , 首先 需要 清楚 它们 之 间 的 
关系 。 

如 果 是 activity 的 数据 回 传 ， 我 们 调用 startActivityForResult(...) 方 法 ，Activity- 
Manager 负 责 跟 踪 管 理 activity 父 子 关系 。 回 传 数据 后 ， 子 activity 被 销毁 ， et noe 
接收 数据 的 是 哪个 activity。 

1. 设置 目标 fragment 

类 似 于 activity 间 的 关联 , 可 将 CrimeFragment 设 置 成 DatePickerFragment 的 目标 fragment。 
这 样 ， 在 CrimeFragment 和 DatePickerFragment 被 销毁 并 重建 后 ， 操 作 系 统 会 重新 关联 它们 。 
调用 以 下 Fragment 方 法 可 建立 这 种 关联 : 

public void setTargetFragment(Fragment fragment, int requestCode) 

该 方法 有 两 个 参数 : 目标 fragment 以 及 类 似 于 传人 startActivityForResult(...) 方 法 的 
请 求 代 码 。 需 要 时 ， 目 标 fragment 使 用 请 求 代 码 确认 是 哪个 fragment 在 回 传 数 据 。 

目标 fragment 和 请 求 代码 由 FragmentManager 负 责 跟踪 管理 ， 我 们 可 调用 fragment (设置 
目标 fragment 的 fagment ) 的 getTargetFragment() 方 法 和 getTargetRequestCode() 方 法 获 
取 它 们 。 

在 CrimeFragmentjava 中 ， 创 建 请 求 代 码 常量 ， 然 后 将 CrimeFragment 设 为 DatePicker- 
Fragment 实 例 的 目标 fragment， 如 代码 清单 12-8 所 示 。 






































代码 清单 12-8 设置 目标 fragment ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 


private static final String ARG CRIME ID = "crime id"; 
private static final String DIALOG DATE = "DialogDate"; 


private static final int REQUEST DATE = 0; 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


mDateButton.setOnClickListener(new View.0nCLickListener() { 

@Override 

public void onClick(View v) { 
FragmentManager manager = getFragmentManager(); 
DatePickerFragment dialog = DatePickerFragment 

.newInstance(mCrime.getDate() ) ; 

dialog.setTargetFragment (CrimeFragment.this, REQUEST_DATE); 
dialog.show(manager, DIALOG DATE); 
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} 
}); 
return v; 

} 

2. 传递 数据 给 目标 fragment 

建立 CrimeFragment 与 DatePickerFragment 之 间 的 联系 后 ， 需 将 数据 回 传 给 CrimeFragment。 
回 传 日 期 将 作为 extra 附 加 给 Intent。 

使 用 什么 方法 发 送 intent 信 息 给 目标 fragment? 虽然 邻 人 难以 置信 ， 但 是 我 们 会 让 
DatePickerFragment 类 调用 CrimeFragment.onActivityResult(int，int，Intent) 方 法 。 

Activity.onActivityResutLt(...) 方 法 是 ActivityManager 在 子 activity 被 销毁 后 调用 的 父 
activity 方 法 。 处 理 activity 间 的 数据 返回 时 ActivityManager 会 自动 调用 Activity .onActivity- 
Result(...) 方 法 。 父 activity 接 收 到 Activity.onActivityResult(...) 方 法 调用 命令 后 ， 其 
FragmentManager 会 调用 对 应 fragment 的 Fragment. tReet . ) 方 法 。 

处 理由 同一 activity 托 管 的 两 个 fragment 间 的 数据 返回 时 ， 可 借用 Fragment .onActivity- 
Result(...) 方 法 。 因 此 ， 直 接 调 用 目标 fragment 的 Fragment.onActivityResult(...) 方 法 ， 
就 能 实现 数据 的 回 传 。 该 方法 恰好 有 我 们 需要 的 如 下 信息 。 

口 请 求 代 码 : 与 传人 setTargetFragment(.. ,) 方 法 的 代码 相 匹配 ， 告 诉 目标 fragment 返 回 
结果 来 自 哪里 。 

D 结果 代码 : 决定 下 一 步 该 采取 什么 行动 。 

口 Intent: 包含 extra 数 据 。 

在 DatePickerFragment 类 中 , 新 建 sendResult(,.,) 私 有 方法 , 创建 intent 并 将 日 期 数据 作为 
extra 附 加 到 intent 上 。 最 后 调用 CrimeFragment. Gt a: , ) 方 法 ， 如 代码 清单 12-9 
所 示 。 


代码 清单 12-9 ”回调 目标 fragment ( DatePickerFragment.java ) 


public class DatePickerFragment extends DialogFragment { 






























































public static final String EXTRA DATE = 
"com.bignerdranch.android.criminalintent.date"; 


private static final String ARG DATE = "date"; 
@Override 
public Dialog onCreateDialog(Bundle savedInstanceState) { 
} 
private void sendResult(int resultCode, Date date) { 
if (getTargetFragment() == null) { 


return; 


} 
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Intent intent = new Intent(); 
intent.putExtra(EXTRA DATE, date); 


getTargetFragment() 
.OnNActivityResult(getTargetRequestCode(), resultCode, intent); 


} 


现在 来 使 用 sendResult(...) 私 有 方法 。 用 户 点 击 对 话 框 中 的 positive 按 钮 时 ， 需 要 从 
DatePicker 中 获取 日 期 并 闻 信 站 imeradinerit 。 在 onCreateDialog(...) 方 法 中 ， 替 换 掉 
setPositiveButton(,.,) 的 null 参 数值 ， 实 现 DialogInterface. OnctickListener 胜 听 需 接 口 。 
在 ! 监听 器 接口 的 onCLick(， , ) 方 法 中 , 获取 日 期 并 调用 sendResult(...) 方 法 , 如 代码 清单 12-10 
所 示 。 


代码 清单 12-10 “一切 是 否 都 OK? ( DatePickerFragment.java ) 


GOverride 
public Dialog onCreateDialog(Bundle savedInstanceState) { 





























return new AlertDialog.Builder(getActivity()) 
.SetView(V) 
.SetTitle(R.string.date picker title) 
“SetPositiveButton(android.R.string.ok, nultl); 
.SetPositiveButton(android.R.string.ok, 
new DiaLogInterface.0nCLickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
int year = mDatePicker.getYear(); 
int month = mDatePicker.getMonth(); 
int day = mDatePicker.getDay0fMonth(); 
Date date = new GregorianCalendar(year, month, day).getTime(); 
sendResult(Activity .RESULT OK, date); 


} 
}) 
.Create(); 
} 


在 CrimeFragment 中 ， 覆 盖 onActivityResuLt(...) 方 法 ， 从 extra 中 获取 日 期 数据 ， 设 置 
对 应 Crime 的 记录 日 期 ， 然 后 刷新 日 期 按钮 的 显示 ， 如 代码 清单 12-11 所 示 。 


代码 清单 12-11 ”响应 DatePicker 对 话 框 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 


























@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


} 


@Override 
public void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (resultCode != Activity.RESULT OK) { 
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return; 


} 


if (requestCode == REQUEST DATE) { 


Date date = (Date) data 
.getSerializableExtra(DatePickerFragment .EXTRA DATE); 


mCrime.setDate(date); 
mDateButton.setText (mCrime.getDate().toString()); 


} 
在 onCreateView(,..) 和 onActivityResult(...) 这 两 个 方法 中 ,设置 按钮 显示 文字 的 代 


码 完全 一 样 。 为 了 各 免 代码 元 余 ， 可 以 将 其 封装 到 updateDate ( ) 私 有 方法 中 ， 然 后 分 别 调用 。 
除 手动 封装 代码 的 方式 外 ， 还 可 以 使 用 Android Studio 的 内 置 工 具 。 高 亮 选 取 设 置 
mDateButton 显 示 文 字 的 代码 ， 如 代码 清单 12-12 所 示 。 


代码 清单 12-12 ”高 亮 选取 日 期 按钮 更 新 代码 〈CrimeFragmentjava ) 
@Override 
public void onActivityResult(int requestCode, int resultCode, intent data) { 
if (resultCode != Activity.RESUIT OK) { 
return; 























} 


if (requestCode == REQUEST DATE) { 


Date date = (Date) data 
.getSerializableExtra(DatePickerFragment.EXTRA DATE); 


mCrime.setDate(date); 
mDateButton.setText (mCrime.getDate().toString()); 























} 
} 
右键 单 击 并 选择 Refactor 一 Extract 一 Method... 荣 单项 ， 弹 出 如 图 12-10 所 示 的 界面 。 
全 中 J Extract Method 
Visibility: Name: 
private 周 updateDate 








Declare static (pass fields as params) 


Parameters 


Type Name 


Nothing to show 


Signature Preview 
private void updateDate() 


Cancel BLD 














图 12-10 使 用 Android Studio 抽 取 方 法 
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设置 方法 为 私有 并 将 其 命名 为 updateDate。 点 击 OK 按钮 ， Android Studio 会 提示 还 有 其 他 地 
方 使 用 了 这 段 代码 。 点 击 Yes 允 许 它 自动 处 理 。 然 后 确认 updateDate 方 法 封装 完成 并 在 相应 地 方 
已 调用 ， 如 代码 清单 12-13 所 示 。 


代码 清单 12-13 ”使 用 updateDate() 私 有 方法 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 








@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment crime, container, false); 


mDateButton = (Button) v.findViewById(R.id.crime date); 
updateDate(); 


} 


@Override 
public void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (resultCode != Activity.RESULT OK) { 
return; 


上 


if (requestCode == REQUEST DATE) { 
Date date = (Date) data 
.getSerializableExtra(DatePickerFragment.EXTRA DATE); 
mCrime.setDate (date); 
updateDate(); 


} 


private void updateDate() { 
mDateButton.setText(mCrime.getDate().toString()); 





} 
} 


日 期 数据 的 双向 传递 完成 了 。 运 行 CriminalIntent 应 用 ,确保 可 以 控制 日 期 的 传递 与 显示 。 修 
改 某 项 Crime 的 日 期 , 确认 CrimeFragment 视 图 显示 0 日 期 。 然后 返回 crime 列 表 项 界面 ,查看 
对 应 Crime 的 日 期 ， 并 确认 模型 层 数 据 已 得 到 更 新 。 

3. 更 为 灵活 的 DialogFragment 视 图 展现 
编写 需要 用 户 大 量 输入 以 及 要 求 更 多 空间 显示 输入 的 应 用 , 并 且 要 让 应 用 同时 支持 手机 和 平 
板 设备 时 ， 使 用 onActivityResuLt(.,.) 方 法 返回 数据 给 目标 fragment 是 比较 方便 的 。 

手机 屏幕 空间 有 限 ， 因 此 通常 需要 使 用 activity 托 管 全 屏 的 fagment 界 面 ， 以 显示 用 户 输入 要 
求 。 re 由 父 activity 的 fragment 以 调用 startActivityForResult(...) 方 法 的 方式 启 
动 。 子 activity 被 销毁 后 ， 父 activity 会 接收 到 onActivityResult(. ,) 方 法 的 调用 请 求 ， 并 将 之 
转发 给 启动 子 activity 的 fragment， 如 图 12-11 所 示 。 
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:| startActivityForResult(...) |: 
Fragment A 下 二 二 Fragment B 

















onActivityResult(...) : 
Fragment A 全 Fragment B 











图 12-11 手机 设备 上 activity 间 的 数据 传递 


平板 设备 的 屏幕 比较 大 ， 适 合 以 弹出 对 话 框 的 方式 显示 信息 和 接收 用 户 输入 。 这 种 情况 下 ， 
应 设置 目标 fragment 并 调 oa 的 show(,,,) 方 法 。 对 话 框 被 取消 后 ， 对 话 框 fagment 
会 调用 目标 fragment 的 onActivityResult(. _) 方 法 ， 如 图 12-12 所 示 。 

无 论 是 启动 子 activity 还 是 显示 对 话 框 ， 人 onActivityResult(...) 方 法 总 会 被 调 
用 。 因 此 ， 可 使 用 相同 的 代码 实现 不 同 的 信息 呈现 。 
写 同样 的 代码 用 于 全 屏 fragment 或 对 话 框 fagment 时 ， 可 选择 覆盖 DialogFragment. 
onCreateView(...) 方 法 ， 而 非 onCreateDialog(...) 方 法 ， 以 实现 不 同 设备 上 的 信息 呈现 。 
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AN 


setTargetFragment( ..) 


/ 
Fragment A 只 


Fragment B 


(显示 为 对 话 框 ) 





/~ ~ 


onActivityResult(.. ) 





7 
FragmentA J 
a NN 


Fragment B 


(显示 为 对 话 框 ) 











图 12-12 平板 设备 上 fragment 间 的 数据 传递 





12.3 ”挑战 练习 : 更 多 对 话 框 


首先 看 一 个 简单 的 练习 。 男 写 一 个 名 为 TimePickerFragment 的 对 话 框 fragment， 人 允许 用 户 
使 用 TimePicker 组 件 选 择 crime 发 生 的 具体 时 间 。 在 CrimeFragment 用 户 界面 上 再 添加 一 个 按 
钮 ， 以 显示 TimePickerFragment 视 图 界面 。 


























12.4 ”挑战 练习 : 实现 响应 式 DialogFragment 
再 来 看 一 个 有 些 难 度 的 练习 : 优化 DatePickerFragment 的 呈现 方式 。 
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要 完成 这 个 挑战 ， 初 步 分 析 需 三 大 步 。 第 一 步 ， 替 换 掉 onCreateDiatog(BundtLe) 方 法 ,， 改 
用 onCreateView(...) 方 法 来 创建 DatePickerFragment 的 视图 。 以 这 种 方式 创建 Dialog- 
Fragment 的 话 ， 在 对 话 框 界面 上 看 不 到 标题 区 域 ， 同 样 也 没有 放置 按钮 的 空间 。 这 需要 你 自行 
在 dialog _date.xml 布 局 中 创建 OK 按钮 。 

有 了 DatePickerFragment 视 图 ， 接 下 来 就 能 以 对 话 框 或 以 在 activity 中 内 山 的 方式 展现 。 第 
二 步 ， 创建 singleFragmentActivity 子 类 。 它 的 任务 就 是 托管 DatePickerFragment。 

选择 这 种 方式 展现 DatePickerFragment， 就 要 使 用 startActivityForResult(..,.) 方 法 
回 传 日 期 给 CrimeFragment。 在 DatePickerFragment 中 ， 如 果 目 标 fragment 不 存在 ， 就 调用 托 
管 activity 的 setResult (int，intent) 方 法 回 传 日 期 给 CrimeFragment。 

最 后 ， 修 改 CriminalIntent 应 用 : 如 果 是 手机 设备 ， 就 以 全 屏 activity 的 方式 展现 
DatePickerFragment; 如 果 是 平板 设备 ， 就 以 对 话 框 的 方式 展现 DatePickerFragment。 想 知 
道 如 何 按 设备 屏幕 大 小 优化 应 用 ， 请 提前 学 习 第 17 章 的 相关 内 容 。 







































































优秀 的 Android 应 用 都 注重 工具 栏 设 计 。 工 具 栏 可 放置 菜单 选项 、 提 供应 用 导航 ， 还 能 帮助 
统一 设计 风格 、 塑 造 品牌 形象 。 

本 章 , 我 们 为 CriminalIntent 应 用 创建 工具 栏 菜单 ,提供 新 增 crime 记 录 的 菜单 项 , 并 实现 向 上 
按钮 的 导航 功能 ， 如 图 13-1 所 示 。 








CriminalIntent Criminalintent 





Crime #0 fo = 


Mon Nov 21.15:1T:29 EST 2016 Crime #0 
用 于 新 增 Crime #1 DETAILS 
crime 记 录 Mon Nov 21 15:11:29 EST 2016 MON NOV 21 16:35:32 EST 2016 


的 菜单 项 Crime #2 9o 


Mon Nov 21 15:11:29 EST 2016 





向 上 按钮 
Solved 


Crime #3 

Mon Nov 21 15:11:29 EST 2016 

Crime #4 9 
Mon Nov 21 15:11:29 EST 2016 、 
Crime #5 

Mon Nov 21 15:11:29 EST 2016 

Crime #6 9o 
Mon Nov 21 15:11:29 EST 2016 着 


Crime #7 
Mon Nov 21 15:11:29 EST 2016 





Crime #8 9o 





图 13-1 CriminalIntent 应 用 的 工具 栏 


13.1 AppCompat 


Android 5.0( Lollipop ) 引入 了 工具 栏 这 个 新 增 组 件 。 在 Lollipop 之 前 ， 应 用 中 用 于 导航 或 提 
供 菜 单 操作 的 是 操作 栏 。 

工具 栏 和 操作 栏 有 些 类 似 , 但 它 基于 操作 栏 进化 而 来 。 因 此 ,工具 栏 的 界面 更 美观 , 使 用 更 
方便 。 
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CriminalIntent 应 用 最 低 只 支持 API 19 级 , 原生 工具 栏 无 法 文 持 更 老 版 本 的 系统 ,不 过 , Google 
已 将 它 移植 到 了 AppCompat 库 。 这 样 一 来 ， 老 版 本 系统 (API 9 级 、Android 2.3 以 上 ) 就 都 能 使 用 
Lollipop 上 的 工具 栏 了 。 











使 用 AppCompat 库 


我 们 已 经 用 过 AppCompat 库 。 本 书 撰写 时 ， 新 项 目 都 会 默认 使 用 这 个 库 。 如 果 想 给 老 项 目 添 
加 AppCompat 库 ， 该 如 何 做 呢 ? 这 需要 你 做 几 件 事情 。 

要 整合 使 用 AppCompat 库 ， 你 需要 
口 添加 AppCompat 依 赖 项 ; 
口 使 用 一 种 AppCompat 主 题 ; 
口 确保 所 有 activity 都 是 AppCompatActivity 子 类 。 

1. 更 新 主题 

在 第 7 章 ， 我 们 已 经 为 CriminalIntent 项 目 添加 过 依赖 项 ， 接 下 来 至 少 要 使 用 一 种 AppCompat 主 
题 。AppCompat 库 自 带 以 下 三 种 主题 。 
口 Theme .AppCompat: 黑色 主题 
口 Theme .AppCompat .Light: 浅 色 主题 
口 Theme.AppCompat .Light.DarkActionBar: 带 黑 色 工 具 栏 的 浅 色 主题 

应 用 级 别 的 主题 设置 在 AndroidManifestxml 文 件 中 进行 。 主 题 也 可 按 activity 配 置 。 打 开 
AndroidManifest.xml 文 件 ， 查 看 appLication 标 签 的 android :theme 属 性 ， 应 该 可 以 看 到 如 代码 
清单 13-1 所 示 的 主题 配置 。 


代码 清单 13-1 各 种 manifest 配 置 项 ( AndroidManifest.xml ) 


<appLication 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme" > 


AppTheme 定 义 在 res/values/styles.xml 文 件 中 。 打 开 这 个 文件 ， 参 照 代码 清单 13-2 设 置 应 用 的 
主题 。 这 个 文件 里 还 有 一 些 其 他 属性 ， 暂 时 不 用 理会 ， 后 面 会 更 新 。 


代码 清单 13-2 使 用 AppCompat 主 题 ( res/values/styles.xml ) 


<resources> 






























































<style name="AppTheme" parent="Theme.AppCompat. light.DarkActionBar"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 
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</resources> 

在 第 22 章 ， 我 们 还 会 进一步 学 习 与 样式 和 主题 相关 的 知识 。 

2. 使 用 AppCompatActivity 

最 后 一 步 是 让 activity 类 继承 AppCompatActivity 类 。 自 第 7 章 开始 ， 我 们 就 已 经 在 用 
AppCompatActivity， 所 以 这 步 略 过 。 

运行 CriminalIntent 应 用 。 若 一 切 正常 ， 应 该 可 以 看 到 如 图 13-2 所 示 的 画面 。 


BA RAY 
Criminallntent 








Crime #0 9o 
Mon Nov 21 14:49:45 EST 2016 
Crime #1 

Mon Nov 21 14:49:45 EST 2016 

Crime #2 eco 
Mon Nov 21 14:49:45 EST 2016 
Crime #3 

Mon Nov 21 14:49:45 EST 2016 

Crime #4 oo 
Mon Nov 21 14:49:45 EST 2016 E 
Crime #5 

Mon Nov 21 14:49:45 EST 2016 

Crime #6 fo 
Mon Nov 21 14:49:45 EST 2016 
Crime #7 

Mon Nov 21 14:49:45 EST 2016 

Crime #8 9 


图 13-2” 换 了 主题 的 工具 栏 
现在 ， 可 以 着 手 添加 工具 栏 菜单 了 。 


























13.2 ”工具 栏 菜单 


工具 栏 菜单 由 菜单 项 〈 又 称 操 作 项 ) 组 成 , 它 占据 着 工具 栏 的 右上 方 区 域 。 菜 单项 的 操作 应 
用 于 当前 屏幕 ， 其 至 整个 应 用 。 现 在 ,我 们 来 添加 允许 用 户 新 增 crime 记 录 的 菜单 项 。 

菜单 及 菜单 项 需 用 到 一 些 字符 串 资源 。 参 照 代 码 清单 13-3， 将 它们 添加 到 strings.xml 文 件 中 。 
有 些 字符 串 资 源 现在 还 用 不 到 ， 但 方便 起 见 ， 一 并 完成 添加 。 


代码 清单 13-3 ”添加 字符 串 资源 (res/values/strings.xml ) 


<resources> 






































<string name="date picker title">Date of crime:</string> 
<string name="new_crime">New Crime</string> 

<string name="show _ subtitle">Show Subtitle</string> 
<string name="hide_subtitle">Hide Subtitle</string> 
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<string name="subtitle format">%1$d crimes</string> 


</resources> 


13.2.1 在 XML 文件 中 定义 菜单 


菜单 是 一 种 类 似 于 布局 的 资源 。 创 建 菜单 定义 文件 并 将 其 放置 在 resmenu 目 录 下 ，Android 
会 自动 生成 相应 的 资源 ID。 随 后 ， 在 代码 中 实例 化 菜单 时 ， 就 可 以 直接 使 用 。 

在 项 目 工 具 窗 口中 ,右键 单 击 res 目 录 ， 选 择 New 一 Androidresource file 菜 单项 。 在 弹出 的 窗 
口 界面 , 选择 Menu 资 源 类 型 , 并 命名 资源 文件 为 fagment crime list, 点 击 OK 按钮 确认 , 如 图 13-3 
所 示 。 





























© New Resource File 

File name: fragment_crime_list I 
Resource type: Menu 

Root element: menu 


Source set: main 


Directory name: menu 
Available qualifiers: 


从 Country Code 


©@: Network Code 


Chosen qualifiers: 


3 Language 
加 de 一 ts Nothing how 
加 Smallest Screen width 
Screen Width 
四 Screen Height 
局 Size 
Eratio 
和 启 orientation 


Cancel | oR 








图 13-3 ”创建 菜单 定义 文件 





这 里 ， 菜 单 定义 文件 遵循 了 与 布局 文件 一 样 的 命名 原则 。Android Studio 会 创建 res/menu/ 
fragment_ crime list.xml 文 件 。 这 个 文件 和 CrimeListFragment 的 布局 文件 同名 , 但 分 别 位 于 不 同 
的 目录 。 打 开 新 建 的 fragment_crime list.xml 文 件 。 参 照 代码 清单 13-4， 添 加 新 的 item 元 素 。 


代码 清单 13-4 ”创建 菜单 资源 (res/menu/fragment crime list.xml ) 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 
<item 

android:id="@+id/new_crime" 
android:icon="@android:drawable/ic_menu_add" 
android:title="@string/new_crime" 
app:showAsAction="ifRoom|withText"/> 

</menu> 











showAsAction 属 性 用 于 指定 菜单 项 是 显示 在 工具 栏 上 ， 还 是 隐藏 于 溢出 菜单 (overflow 
menu )。 该 属性 当前 设置 为 ifRoom 和 withText 的 组 合 值 。 因 此 ， 只 要 空间 足够 ， 菜 单项 图 标 及 
其 文字 描述 都 会 显示 在 工具 栏 上 。 如 果 空 间 仅 够 显示 菜单 项 图 标 , 文字 描述 就 不 会 显示 。 如 果 空 
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间 大 小 不 够 显示 任何 项 ， 菜 单项 就 会 隐藏 到 溢出 菜单 中 。 
如 果 溢 出 菜单 包含 其 他 项 ， 它 们 就 会 以 三 个 点 表示 (位 于 工具 栏 最 右 端 )， 如 图 13-4 所 示 。 
稍 后 ， 我 们 就 会 更 新 代码 添加 这 样 的 菜单 项 。 











Criminallntent 








Crime #0 
Mon Nov 21 16:42:15 EST 2016 


Crime #1 
Mon Nov 21 16:42:15 EST 2016 
Crime #2 
Mon Nov 21 16:42:15 EST 2016 
Crime #3 
Mon Nov 21 16:42:15 EST 2016 
Crime #4 
Mon Nov 21 16:42:15 EST 2016 
Crime #5 
Mon Nov 21 16:42:15 EST 2016 
Crime #6 
Mon Nov 21 16:42:15 EST 2016 
Crime #7 


Mon Nov 21 16:42:15 EST 2016 


Crime #8 


























1. app 命 名 空间 








图 13-4 ”工具 栏 中 的 溢出 菜单 
属性 showAsAction 还 有 另外 两 个 可 选 值 : atways 和 never。 不 推荐 使 用 atways ， 应 尽量 使 


用 ifRoom 属 性 值 ， 让 操作 系统 决定 如 何 显示 菜单 项 。 对 于 那些 很 少 用 到 的 菜单 项 ，never 属 性 值 
是 个 不 错 的 选择 。 总 之 ， 为 了 避免 用 户 界面 混乱 ， 工 具 栏 上 只 应 放置 常用 菜单 项 。 














注意 ， 不 同 于 常见 的 android 命 名 空间 声明 ，fragment_crime_list.xml 文 件 使 用 xmtns 标 签 定 
义 了 全 新 的 app 命 名 空间 。 指 定 showAsAction 属 性 时 ， 就 用 了 这 个 新 定义 的 命名 空间 。 

















出 于 兼容 性 考虑 ，AppCompat 库 需要 使 月 











有 app 命 名 空间 。 操 作 栏 API 随 Android 3.0 引 入 。 为 了 














支持 各 种 旧 系 统 版 本 设备 , 早期 创建 的 AppCompat 库 捆绑 了 兼容 版 操作 栏 。 这 样 一 来 ,不管 新 旧 ， 
所 有 设备 都 能 用 上 操作 栏 。 在 运行 Android 2.3 或 更 早 版 本 系统 的 设备 上 ， 菜 单 及 其 相应 的 XML 
文件 确实 是 存在 的 ， 但 是 android:showAsAction 属 性 是 随 着 操作 栏 的 发 布 才 添加 的 。 








AppCompat 库 不 希望 使 用 原生 showAsAction 
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生 (app:showAsAction )。 
2. 使 用 Android Asset Studio 

















属性 ,因此 ， 它 提供 了 定制 版 showAsAction 属 





应 用 使 用 的 图 标 有 两 种 : 系统 图 标 和 项 目 资源 图 标 。 系 统 图 标 (system icon ) 是 Android 操 作 
系统 内 置 的 图 标 。android:icon 属 性 值 GQandroid:drawable/ic _menu_add 就 引用 了 系统 图 标 。 
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在 应 用 原型 设计 阶段 , 使 用 系统 图 标 不 会 有 什么 问题 ; 而 在 应 用 发 布 时 , 无论 用 户 运行 什么 
设备 , 最 好 能 统一 应 用 的 界面 风格 。 要 知道 , 不同 设备 或 操作 系统 版 本 间 ， 系 统 图 标的 显示 风格 
差异 很 大 。 有 些 设备 的 系统 图 标 甚至 与 应 用 的 整体 风格 完全 不 搭 。 

一 种 解决 方案 是 创建 定制 图 标 。 这 需要 针对 不 同 屏幕 显示 密度 或 各 种 可 能 的 设备 配置 , 准备 
不 同 版 本 的 图 标 。 访 问 developer.android.com/design/style/iconography.html， 查 看 Android 的 图 标 设 
计 指 南 ， 可 了 解 更 多 相关 信息 。 

另 一 种 解决 方案 是 找到 适合 应 用 的 系统 图 标 , 将 它们 直接 复制 到 项 目的 drawable 资 源 目 录 中 。 

系统 图 标 可 在 Android SDK 的 安装 目录 下 找到 。 如 果 是 Mac 计 算 机 ， 路 径 通 常 为 /Users/user/ 
Library/Android/sdk; 如 果 是 Windows 计 算 机 ， 默 认 的 路 径 是 \Usersvusersdk。 此 外 ， 还 可 以 打开 
项 目 结构 窗口 ， 选 择 SDK Location 来 确认 SDK 的 具体 存放 路 径 。 

打开 SDK 目 录 ， 可 找到 包括 ic_menu add 在 内 的 Android 系 统 资源 。 资 源 的 具体 目录 是 
platforms/android-2S/data/res， 路 径 中 的 数字 25 代 表 Android 的 API 级 别 。 

还 有 第 三 个 、 也 是 最 容易 的 解决 方案 : 使 用 Android Studio 内 置 的 Android Asset Studio 工 具 。 
你 可 以 用 它 为 工具 栏 创 建 或 定制 图 片 。 

在 项 目 工具 窗口 中 ， 右 键 单 击 drawable 目 录 ， 选 择 New 一 Image Asset 荣 单项 ， 弹 出 如 图 13-5 
所 示 的 Asset Studio 窗 口 。 





































































































© @ Asset Studio 





(@lo] ile lt RS 





















































ZX Android Studio 
Icon Type: ”Action Bar and Tab lcons 过 Source Asset: 
Name: ic_menu_add 
Asset Type: Image © clip Ar Text 十 
Clip Art: 十 
Trim: Yes QOnNo 
Padding: rr 0% 
Theme: HoLo_DARk 加 
xxhdpi xhdpi hdpi mdpi 
? Cancel Previous | ”Next” | Finish 





图 13-5 Asset Studio 


这 里 ， 我 们 可 以 生成 各 类 图 标 。 在 Icon Type 一 栏 选 Action Bar and Tab Icons ， 在 Name 一 栏 输 
人 和 ic menu add，Asset Type 处 选 Clip Art， 最 后 ， 更 新 Theme 为 HOLO_DARK。 工具 栏 使 用 了 深 色 
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系 主题 ， 那 图 标 图 像 就 应 选 浅 色 。 
现在 ， 点 击 Clip Art 按 钮 挑选 剪贴 画图 片 。 在 弹出 的 剪贴 画 窗口 ， 选 择 看 上 去 像 + 号 的 图 片 ， 
如 图 13-6 所 示 。 


These icons are available under the CC-BY license 
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图 13-6 ”可 选 的 剪贴 画 


点 击 OK 按钮 确认 ， 然 后 单 击 Next 按 钮 进入 如 图 13-7 所 示 的 预览 画面 。 这 个 预览 画面 告诉 我 
们 ，Asset Studio 将 会 产生 hdpi、mdpi、xhdpi 和 xxhdpi 类 型 的 图 标 。 | 


图 也 @ Asset Studio 





Confirm Icon Path 
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Res Directory: main 局 





Output Directories: main 
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Y Ddrawable-hdpi 
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w Ddrawable-xxhdpi 


ic_menu_add.png 


? Cancel Previous Next ”二 


图 13-7 Asset Studio 生 成 的 文件 
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最 后 ， 点 击 Finish 按 钮 生成 图 像 。 然 后 ， 在 布局 文件 中 ， 修 改 布局 文件 中 的 android:icon 
属性 ， 在 项 目 中 使 用 新 图 像 ， 如 代码 清单 13-5 所 示 。 
代码 清单 13-5 3 引用 资源 (res/menu/fragment crime list.xml ) 

<item 


android: id= "@+id/new_ crime" 














do or ri de ni el 
android:title="@string/new crime" 
app:showAsAction="ifRoom|withText"/> 


13.2.2 ”创建 菜单 
在 代码 中 ，Activity 类 提供 了 管理 表单 的 回调 隐 数 。 需 要 选项 菜单 时 ，Android 会 调用 
Activity 的 onCreate0ptionsMenu(Menu) 方 法 。 
然而 ， 按 照 CriminalIntent 应 用 的 设计 ， 与 选项 菜单 相关 的 回调 函数 需 在 fragment 而 非 activity 
里 实现 。 不 用 担心 ，Fragment 有 一 套 自 己 的 选项 菜单 回调 函数 。 稍 后 ,我 们 会 在 
CrimeListFragment 中 实现 这 些 方法 。 以 下 为 创建 菜单 和 响应 菜单 项 选择 事件 的 两 个 回调 方法 : 


public void onCreate0ptionsMenu(Menu menu, MenuInflater inflater) 
public boolean onOptionsItemSelected(MenuItem item) 





























在 CrimeListFragmentjava 中 ， 覆 盖 onCreate0ptionsMenu(Menu，MenuInfLater) 方 法 ， 实 
例 化 fragment_ crime list.xml 中 定义 的 菜单 ， 如 代码 清单 13-6 所 示 。 


代码 清单 13-6 ”实例 化 选项 菜单 ( CrimeListFragment.java ) 


@Override 

public void onResume() { 
super.onResume(); 
updateUI(); 

} 


@Override 

public void onCreate0ptionsMenu(Menu menu, MenuInflater inflater) { 
super.onCreateOptionsMenu(menu, inflater); 
inflater.inflate(R.menu.fragment crime list, menu); 


在 以 上 方法 中 ,我们 调用 MenuInflater.inflate(int，Menu) 方 法 并 传人 菜单 文件 的 资源 
ID， 将 布局 文件 中 定义 的 菜单 项 目 填充 到 Menu 实 例 中 。 
注意 ,我 们 也 调用 了 超 类 的 onCreate0ptionsMenu(...) 方 法 。 当 然 , 也 可 以 不 调 , 但 作为 
一 项 开发 规范 , 有 理由 推荐 这 么 做 。 调 用 该 超 类 方法 ， 任何 超 类 定义 的 选项 菜单 功能 在 子 类 方法 
中 都 能 获得 应 用 。 不 过 ,onCreate0ptionsMenu( ..,) 超 类 方法 什么 也 没 做 ,这 里 的 调用 仅仅 是 
遵循 约定 而 已 。 


Fragment.onCreate0ptionsMenu(Menu，MenuInfLater) 方 法 是 由 FragmentManager 负 责 
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调用 的 。 因 此 ， 当 activity 接 收 到 操作 系统 的 onCreate0ptionsMenu(...) 方 法 回调 请 求 时 , 我 们 
必须 明确 告诉 FragmentManager: 其 管理 的 fragment 应 接收 onCreate0ptionsMenu(...) 方 法 的 
调用 指令 。 要 通知 FragmentManager， 需 调用 以 下 方法 : 


public void setHasOptionsMenu(boolean hasMenu) 





定 义 CrimeListFragment.onCreate(Bundle) 方法 ， 让 FragmentManager 知道 CrimeList- 
Fragment 需 接收 选项 菜单 方法 回调 ， 如 代码 清单 13-7 所 示 。 


代码 清单 13-7 调用 setHas0ptionsMenu 方 法 ( CrimeListFragment.java ) 
public class CrimelistFragment extends Fragment { 


private RecyclerView mCrimeRecyclerView; 
private CrimeAdapter mAdapter; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setHasOptionsMenu (true); 

} 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 


运行 CriminalIntent 应 用 ， 查 看 新 创建 的 菜单 项 ， 如 图 13-8 所 示 。 


A 7:00 
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Crime #0 Qo 


Mon Nov 21 15:11:29 EST 2016 


Crime #1 
Mon Nov 21 15:11:29 EST 2016 


Crime #2 9 DO 
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Mon Nov 21 15:11:29 EST 2016 
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Crime #8 9o 


图 13-8 ”显示 在 工具 栏 上 的 菜单 项 图 标 
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菜单 项 标题 怎么 没有 显示 ? 大 多 数 手机 设备 在 竖 屏 模式 下 屏幕 空间 有 限 。 因 此 , 应 用 的 工具 

















栏 只 够 显示 菜单 项 图 标 。 长 按 工 具 栏 上 的 菜单 项 图 标 ， 可 弹出 标题 ， 如 图 13-9 所 示 。 
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图 13-9 ”长 按 工具 栏 上 的 








图 标 ， 显 示 菜 单项 标题 








横 屏 模式 下 ， 工 具 栏 会 有 足够 的 空间 同时 显示 菜单 项 图 标 和 标题 ， 如 图 13-10 所 示 。 
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图 标 和 标题 
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13.2.3 ”响应 菜单 项 选择 


为 了 响应 用 户 点 击 New Crime 菜 单项 ， 需 实现 新 方法 以 向 crime 列 表 添 加 新 的 Crime。 在 
CrimeLab.java 中 ， 新 增 一 个 addCrime() 方 法 ， 如 代码 清单 13-8 所 示 。 











代码 清单 13-8 ”添加 新 的 crime ( CrimeLab.java ) 


public void addCrime(Crime c) { 
mCrimes.add(c); 


下 


public List<Crime> getCrimes() { 
return mCrimes; 


} 
既然 可 以 手动 添加 crime 记 录 ， 也 就 没 必 要 再 让 程序 自动 生成 100 条 crime 记 录 了 。 在 
CrimeLab.java 中 ， 删 除 生成 随机 crime 记 录 的 代码 ， 如 代码 清单 13-9 所 示 。 


代码 清单 13-9 ”再见 ， 随 机 crime 记 录 ! (CrimeLab.java ) 


private CrimeLab(Context context) { 

mCrimes = new ArrayList<>(); 
for (int i = 0; i < 100; i++} { 
Crime_ crime = new CrimeO; 











crime.setSolved(i % 2 == 0);// Every other one 
Ee NO rie 
} 
用 户 点 击 菜单 中 的 菜单 项 时 ，fragment 会 收 到 on0ptionsItemSelected(MenuItem) 方 法 的 
回调 请 求 。 传 入 该 方法 的 参数 是 一 个 描述 用 户 选 择 的 MenuItem 实 例 。 
当前 菜单 仅 有 一 个 菜单 项 , 但 菜单 通常 包含 多 个 菜单 项 。 通 过 检查 菜单 项 ID ， 可 确定 被 选中 
的 是 哪个 菜单 项 ,然后 作出 相应 的 响应 。 这 个 了 实际 就 是 在 菜单 定义 文件 中 赋予 菜单 项 的 资源 ID。 13 
在 CrimeListFragment.java 中 ， 实 现 on0ptionsItemSelected(MenuItem) 方 法 ， 以 响应 菜单 
项 的 选择 事件 。 在 该 方法 中 ， 创 建新 的 Crime 实 例 ， 将 其 添加 到 CrimeLab 中 ， 然 后 启动 


CrimePagerActivity 实 例 ， 让 用 户 可 以 编辑 新 创建 的 Crime 记 录 ， 如 代码 清单 13-10 所 示 。 
代码 清单 13-10 ”响应 菜单 项 选择 事件 ( CrimeListFragment.java ) 


GOverride 

public void onCreate0ptionsMenu(Menu menu, MenuInflater infLater) { 
super.onCreateOptionsMenu(menu, inflater); 
inflater.inflate(R.menu.fragment crime list, menu); 





















































. 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
switch (item.getItemId()) { 
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case R.id.new_crime: 
Crime crime = new Crime(); 
CrimeLab.get(getActivity()).addCrime(crime); 
Intent intent = CrimePagerActivity 
.newIntent (getActivity(), crime.getId()); 
startActivity(intent); 
return true; 
default: 
return super.onOptionsItemSelected (item); 
} 
} 
注意 ，on0ptionsItemSelected(MenuItem) 方 法 返回 的 是 布尔 值 。 一 旦 完成 菜单 项 事件 处 
理 , 该 方法 应 返回 true 值 以 表明 任务 已 完成 。 另 外 ,默认 case 表 达 式 中 ， 如 果菜 单项 ID 不 存在 ， 
超 类 版 本 方法 会 被 调用 。 
运行 CriminalIntent 应 用 ， 尝 试 使 用 菜单 ， 添 加 一 些 crime 记 录 并 进行 编辑 。( 新 增 记 录 前 ， 空 
空 如 也 的 列表 看 上 去 不 够 专业 ， 不 用 担心 ， 本 章 末 的 挑战 练习 就 是 为 此 而 设 的 。) 


13.3 ”实现 层级 式 导 航 


目前 为 止 ，CriminalIntent 应 用 主要 靠 后 退 键 在 应 用 内 导航 。 后 退 键 导航 又 称 为 临时 性 导航 ， 
只 能 返回 到 上 一 次 浏览 过 的 用 户 界面 ; 而 层级 式 导 航 (hierarchical navigation, 有 时 又 称 为 ancestral 
navigation ) 可 在 应 用 内 逐 级 向 上 导航 。 

有 了 层级 式 导航 ， 用 户 可 点 击 工 具 栏 左边 的 向 上 按钮 向 上 导航 。 

打开 AndroidManifestxml ， 参 照 代 码 清单 13-11 添 加 parentActivityName 属 性 ， 开 启 
CriminalIntent 应 用 的 层级 式 导 航 。 


代码 清单 13-11 启用 向 上 按钮 (AndroidManifest.xml ) 


<activity 
android:name=".CrimePagerActivity" 
android:parentActivityName=" .CrimeListActivity"> 
</activity> 


运行 应 用 并 创建 新 的 crime 记 录 。 在 屏幕 的 左上 方 ， 可 看 到 如 图 13-11 所 示 的 向 上 按钮 。 点 击 
按钮 可 向 上 一 级 导航 至 CrimeListActivity 用 户 界面 。 
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€ Criminallntent 





图 13-11 CrimePagerActivity 界 面 上 的 向 上 按钮 


层级 式 导航 的 工作 原理 
Criminalintent 必 用 中 ， 后 退 键 导 航 和 向 上 按钮 导航 执行 同样 的 操作 。 在 CrimePagerActivity 
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百 台 实 现 机 制 大 不 相同 。 知 道 这 一 点 很 重要 ， 因 为 取决 于 具体 应 用 ， 向 上 导航 很 可 能 会 让 用 户 迷 
失 在 众多 activity 中 ( 这 里 指 回 退 栈 内 的 众多 activity )。 
用 户 点 击 向 上 按钮 自 CrimePagerActivity 界 面向 上 导航 时 ， 如 下 的 intent 会 被 创建 : 


Intent intent = new Intent(this, CrimeListActivity.class); 
intent.addFlags(Intent.FLAG ACTIVITY CLEAR TOP); 
startActivity(intent); 

finish(); 


FLAG_ACTIVITY_ CLEAR_TOP 指 示 Android 在 回 退 栈 中 寻找 指定 的 activity 实 例 。 如 果实 例 存 在 ， 
则 弹出 栈 内 所 有 其 他 activity, 让 启动 的 目标 activity 出 现在 栈 项 ( 显示 在 屏幕 上 ), 如 图 13-12 所 示 。 


界面 ， 无 论 按 哪个 按钮 导航 ， 都 是 回 到 CrimeListActivity 界 面 。 虽 然 结 果 一 样 ， 但 它们 各 自 的 




























启动 CrimeListActivity 
FLAG_ACTIVITY_CLEAR_TOP 





图 13-12 ”工作 中 的 FLAG_ACTIVITY_ CLEAR_TOP 


13.4 可 选 菜单 项 


在 本 节 中 ， 我 们 将 利用 前 面 学 过 的 菜单 资源 相关 知识 ， 添 加 一 个 菜单 项 来 实现 显示 或 隐藏 
CrimeListActivity 工 具 栏 的 子 标题 (用 来 显示 crime 记 录 条 数 )。 

打开 res/menu/fragment crime listxml 文 件 ， 参 照 代 码 清 单 13-12 ， 新 增 一 个 名 为 SHOW 
SUBTITLE 的 菜单 项 。 如 果 显 示 空间 足够 ， 它 将 显示 在 工具 栏 上 。 13 


代码 清单 13-12 ”添加 SHOW SUBTITLE 荣 单项 (res/menu/fragment crime list xml ) 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 
<item 
android:id="@+id/new crime" 
android:icon="@android:drawable/ic menu add" 
android:title="@string/new crime" 
app:showAsAction="ifRoom|withText"/> 




















<item 
android:id="@+id/show_ subtitle" 
android:title="@string/show_subtitle" 
app:showAsAction="ifRoom"/> 
</menu> 
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子 标题 需 显 示 crime 记 录 条 数 ， 参 照 代码 清单 13-13， 创 建新 方法 updateSubtitle() 实 现 这 
个 需求 。 
代码 清单 13-13 ”设置 工具 栏 子 标题 ( CrimeListFragment.java ) 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 


} 


private void updateSubtitle() { 
CrimeLab crimeLab = CrimeLab.get(getActivity()); 
int crimeCount = crimeLab.getCrimes().size(); 
String subtitle = getString(R.string.subtitle format, crimeCount); 


AppCompatActivity activity = (AppCompatActivity) getActivity(); 
activity.getSupportActionBar().setSubtitle(subtitle); 





getString(int resId，0bject...formatArgs ) 方 法 接受 字符 串 资 源 中 占 位 符 的 替换 值 ， 
updateSubtitle() 用 它 生成 子 标题 字符 串 。 

接着 ， 托 管 CrimeListFragment 的 activity 被 强制 类 型 转换 为 AppCompatActivity。 有 既然 
CriminalIntent 应 用 使 用 了 AppCompat 库 ， 所 有 activity 就 都 是 AppCompatActivity 的 子 类 ， 自 然 
也 能 访问 工具 栏 。( 由 于 兼容 性 问题 ,在 AppCompat 库 中 ， 工 具 栏 在 很 多 地 方 仍 被 称 为 操作 栏 。) 

在 on0ptionsItemSelected(...) 方 法 中 , 调用 updateSubtittLe() 方 法 响应 新 增 荣 单项 的 
单 击 事件 ， 如 代码 清单 13-14 所 示 。 


代码 清单 13-14 ”响应 SHOW SUBTITLE 菜 单项 单 击 事件 ( CrimeListFragment.java ) 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.new crime: 








return true; 
case R.id.show _ subtitle: 
updateSubtitle(); 
return true; 
default: 
return Super.on0ptionsItemSeLected(item) ; 


} 
运行 CriminalIntent 应 用 ， 点 击 SHOW SUBTITLE 菜 单项 ， 确 认 子 标题 显示 出 crime 记 录 条 数 。 


13.4.1 切换 菜单 项 标题 


工具 栏 上 的 子 标题 显示 后 ， 菜 单项 标题 依然 显示 为 SHOW SUBTITLE。 显 然 ， 菜 单项 标题 的 
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切换 与 子 标题 的 显示 或 隐藏 需要 联动 。 

调用 on0ptionsItemSelected(MenuItem) 方 法 时 , 传人 的 参数 是 用 户 点 击 的 MenuItem。 虽 
然 可 以 在 这 个 方法 里 更 新 SHOW SUBTITLE 菜 单项 的 文字 , 但 设备 旋转 并 重建 工具 栏 时 ， 子 标题 
的 变化 会 丢失 。 

比较 好 的 解决 方法 是 在 onCreate0ptionsMenu(.,..,) 方 法 内 更 新 SHOW SUBTITLE 菜 单项 ， 
并 在 用 户 点 击 子 标题 菜单 项 时 重建 工具 栏 。 对 于 用 户 选 择 菜 单项 或 重建 工具 栏 的 场景 , 都 可 以 使 
用 这 段 菜 单项 更 新 代码 。 

首先 新 增 跟踪 记录 子 标题 状态 的 成 员 变 量 ， 如 代码 清单 13-15 所 示 。 









































代码 清单 13-15 ”记录 子 标题 状态 ( CrimeListFragment.java ) 
public class CrimeListFragment extends Fragment { 
private RecyclerView mCrimeRecyclerView; 


private CrimeAdapter mAdapter; 
private boolean mSubtitleVisible; 


接着 ,， 用户 点 击 SHOW SUBTITLE 菜 单项 时 ,在 onCreate0ptionsMenu(...) 方 法 内 更 新 子 
标题 ， 同 时 重建 菜单 项 ， 如 代码 清单 13-16 所 示 。 


代码 清单 13-16 ”更 新 菜单 项 ( CrimeListFragment.java ) 


GOverride 

public void onCreate0ptionsMenu(Menu menu, MenuInflater infLater) { 
super.onCreateOptionsMenu(menu, inflater); 
inflater.inflate(R.menu.fragment crime list, menu); 





MenuItem subtitLeItem = menu.findItem(R.id.show_ subtitle); 
if (mSubtitleVisible) { 
subtitleItem.setTitle(R.string.hide_ subtitle); 
} else { 
subtitleItem.setTitle(R.string.show subtitle); 
} 





} 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.new crime: 


case R.id.show subtitle: 
mSubtitleVisible = !mSubtitleVisible; 
getActivity().invalidateOptionsMenu(); 
updateSubtitle(); 
return true; 

default: 
return super.onOptionsItemSelected(item); 
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最 后 ,根据 mSubtitleVisible 变 量 值 ， 联 动 菜单 项 标题 与 子 标题 ， 如 代码 清单 13-17 所 示 。 


代码 清单 13-17 实现 菜单 项 标题 与 子 标题 的 联动 ( CrimeListFragment.java ) 


private void updateSubtitle() { 
CrimeLab crimeLab = CrimeLab.get(getActivity()); 
int crimeCount = CrimeLab.getCrimes().size(); 
String subtitle = getString(R.string.subtitle format, crimeCount); 





if (!mSubtitleVisible) { 
subtitle = null; 
} 


AppCompatActivity activity = (AppCompatActivity) getActivity(); 
activity.getSupportActionBar().setSubtitle(subtitle); 
} 


运行 CriminalIntent 应 用 ， 确 认 菜 单项 标题 与 子 标 题 能 够 联动 。 


13.4.2 “还 有 个 问题 ” 





解决 Android 编 程 问 题 如 同 对 付 神探 可 伦 坡 * 的 盘问 。 你 以 为 你 的 解决 方案 无 懈 可 击 ， 可 以 高 
枕 无 优 了 ， 但 Android 每 次 都 会 堵 在 门口 提醒 道 :“ 还 有 个 问题 没 解 决 。 

准确 地 说 ， 还 有 两 个 问题 。 首 先 ， 新 建 crime 记 录 后 ， 使 用 后 退 键 回 到 CrimeListActivity 
界面 , 子 标题 显示 的 总 记录 数 不 会 更 新 。 其 次 , 子 标题 显示 后 , 旋转 设备 , 显示 的 子 标 题 会 消失 。 

先 看 记录 刷新 间 题 。 在 返回 CrimeListActivity 界 面 时 ， 再 次 刷新 子 标题 显示 就 能 解决 这 
个 问题 。 也 就 是 说 ， 在 onResume 方 法 里 再 次 调用 updateSubtittLe 方 法 。 既 然 onResume 方 法 和 
onCreateView 方 法 会 调用 updateUI 方 法 ， 那 就 在 updateUI 方 法 里 直接 调用 updateSubtitle 方 
法 ， 如 代码 清单 13-18 所 示 。 


代码 清单 13-18 ”显示 最 新 状态 ( CrimeListFragment.java ) 


private void updateUI() { 
CrimeLab crimeLab = CrimeLab.get(getActivity()); 
List<Crime> crimes = crimeLab.getCrimes(); 







































































if (mAdapter == null) { 
mAdapter = new CrimeAdapter(crimes); 
mCrimeRecyclerView.setAdapter (mAdapter); 
} else { 
mAdapter.notifyDataSetChanged(); 


























} 
updateSubtitle(); 
} 
中 美国 经 典 电视 电影 系列 《神探 可 伦 坡 》 的 主角 。“ 还 有 个 问题 ”( Just one more thing… ) 是 他 在 破案 过 程 中 常 说 的 























一 句 话 。 一 一 编者 注 
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运行 Criminalmntent 应 用 。 显 示 子 标题 ， 然 后 新 建 crime 记 录 并 按 后 退 键 返回 到 CrimeList- 
Activity 界 面 。 可 以 看 到 ， 工 具 栏 显示 的 总 记录 数 没 问题 了 。 

现在 , 重复 上 述 步骤 , 但 这 次 改 用 向 上 按钮 。 注意 看 , 子 标题 显示 被 重 置 了 ! 这 又 是 什么 情况 ? 

这 是 Android 实 现 层级 式 导 航 带 来 的 问题 : 导航 回 退 到 的 目标 activity 会 被 完全 重建 。 既 然 父 
activity 是 全 新 的 ， 实 例 变量 值 以 及 保存 的 实例 状态 显然 会 彻底 丢失 。 

在 向 上 导航 时 保证 子 标 题 的 可 见 状态 并 不 容易 。 一 种 方案 是 覆盖 向 上 导航 的 机 制 。 在 
CriminalIntent 应 用 中 ， 调 用 CrimePagerActivity 的 finish() 方 法 直接 回 退 到 前 一 个 activity 界 
面 。 遗 憾 的 是 ， 这 种 方法 只 能 回 退 一 个 层级 ， 而 实际 开发 的 应 用 绝 大 多 数 都 需要 多 层级 导航 。 

另 一 种 方案 是 在 启动 CrimePagerActivity 时 ， 把 子 标题 状态 作为 extra 信 息 传 给 它 。 然 后 ， 
在 CrimePagerActivity 中 履 盖 getParentActivityIntent() 方 法 ， 用 附带 了 extra 信 息 的 intent 
重建 CrimeListActivity。 这 需要 CrimePagerActivity 类 知道 父 类 工作 机 制 的 细节 。 

上 述 两 种 方案 都 不 够 理想 ,但 目前 没有 更 好 的 方法 。 

无 论 如 何 ，CriminalIntent 应 用 的 子 标题 显示 问题 算是 解决 了 。 现 在 解决 设备 旋转 问题 。 只 要 
利用 实例 状态 保存 机 制 ， 保 存 mSubtitleVisible 实 例 变量 值 就 能 解决 问题 ， 如 代码 清单 13-19 
所 示 。 


代码 清单 13-19 ”保存 子 标题 状态 值 ( CrimeListFragment.java ) 


public class CrimeListFragment extends Fragment { 

































































private static final String SAVED _ SUBTITLE VISIBLE = "subtitle"; 

@Override 

public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


if (savedInstanceState != nuLL) { 
mSubtitleVisible = savedInstanceState.getBooLean(SAVED_SUBTITLE_VISIBLE) ; 
} 


updateUI(); 


return view; 


} 


@Override 
public void onResume() { 


} 


@Override 

public void onSaveInstanceState(Bundle outState) { 
super.onSaveInstanceState(outState); 
outState.putBoolean (SAVED_ SUBTITLE VISIBLE, mSubtitleVisible); 
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运行 CriminalIntent 应 用 。 显 示 子 标题 并 旋转 设备 ， 可 以 看 到 子 标题 在 新 建 视图 中 依然 能 正确 
显示 。 


13.5 ”深入 学 习 : 工具 栏 与 操作 栏 


工具 栏 和 操作 栏 究竟 有 什么 区 别 呢 ? 














By RA) 





Criminallntent SHOW SUBTITLE Criminallntent 十 sHOW SUBTITLE 








图 13-13 工具 栏 ( 右 ) 与 操作 栏 ( 左 ) 


首先 , 两 者 给 我 们 最 直观 的 印象 就 是 工具 栏 界面 更 美观 。 工具 栏 的 左边 不 再 放置 图 标 , 右边 
菜单 项 的 间距 也 更 小 。 另 外 就 是 向 上 的 导航 按钮 。 操 作 栏 上 的 这 个 按钮 不 够 醒目 ， 只 是 旁边 按钮 
的 附属 物 。 

除了 视觉 上 的 差异 ,在 使 用 上 , 工具 栏 比 操作 栏 更 灵活 。 操 作 栏 的 使 用 限制 多 多 ， 比 如 ， 整 
个 应 用 只 能 配置 一 个 操作 栏 且 位 置 及 尺寸 必须 固定 〈 在 屏幕 项 部 )。 工 具 栏 就 没有 这 些 限制 。 

本 章 使 用 的 工具 栏 应 用 了 AppCompat 主 题 。 如 果 有 需要 ， 也 可 以 通过 activity 和 fragment 布 局 
定制 标准 视图 的 工具 栏 。 可 以 在 屏幕 的 任何 位 置 摆 放 工具 栏 , 甚 至 可 以 在 同一 屏 配置 多 个 工具 栏 。 
应 用 设计 的 自由 度 由 此 大 大 提高 了 ， 例 如 ， 可 以 为 每 个 fragment 定制 专用 工具 栏 。 可 以 想象 ,在 
同一 个 用 户 界 面 托管 多 个 fragment 时 ， 每 个 fragment 都 由 自己 的 工具 栏 控 制 ， 这 比 所 有 fragment 
共享 一 个 位 于 屏幕 顶部 的 工具 栏 方便 多 了 。 

此 外 , 工具 栏 还 能 支持 内 能 视图 和 调整 高 度 ， 这 极 大 地 丰富 了 应 用 的 交互 模式 。 训 不 夸张 地 
说 ， 应 用 设计 最 大 的 局 限 就 是 我 们 的 想象 空间 的 局 限 。 


13.6 ”挑战 练习 : 删除 crime 记录 


CriminalIntent 应 用 目前 不 支持 删除 现 有 crime 记 录 。 请 为 CrimeFragment 添 加 菜单 项 ， 人 允许 
用 户 删 除 当 前 crime 记 录 。 用 户 点 击 删除 菜单 项 后 ,记得 调用 CrimeFragment 托 管 活动 的 finish() 
方法 回 退 到 前 一 个 activity 界 面 。 


13.7 ”挑战 练习 : 复数 字符 串 资 源 


只 有 一 条 crime 记 录 的 时 候 ， 显 示 总 记录 数 的 子 标题 会 显示 : 1 crimes。 单 词 crime 仍 用 了 复数 
形式 。 请 改正 这 个 粗心 的 语法 错误 。 

实现 思路 上 , 你 可 以 在 代码 中 准备 不 同 的 字符 串 资 源 并 分 情况 使 用 , 但 这 会 给 应 用 本 地 化 制 
造 麻烦 。 比 较 好 的 做 法 是 使 用 复数 字符 串 资 源 ( 又 称 为 量化 字符 串 )。 

首先 ， 在 strings.xml 文 件 中 定义 复数 字符 串 资 源 。 
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<plurals name="subtitle plural"> 
<item quantity="one">%1$d crime</item> 
<item quantity="other">%1$d crimes</item> 
</plurals> 


然后 ， 使 用 getQuantityString 方 法 正确 处 理 单 复数 问题 。 


int crimeSize = crimeLab.getCrimes().size(); 
String subtitle = getResources() 
.getQuantityString(R.plurals.subtitle plural, crimeSize, crimeSize); 





13.8 ”挑战 练习 : 用 于 RecyclerView 的 空 视图 


当前 ，CriminalIntent 应 用 启动 后 , 会 显示 一 个 空白 列表 。 从 用 户 体 验 上 来 讲 ， 即 使 crime 列 表 
是 空 的 ， 也 应 展示 提示 或 解释 类 信息 。 

请 设置 空 视 图 并 展示 类 似 “ 没 有 crime 记 录 可 以 显示 ”的 信息 。 再 添加 一 个 按钮 ， 方 便 用 户 
直接 创建 新 的 crime 记 录 。 

判断 crime 列 表 是 否 包含 数据 ， 然 后 使 用 任何 类 都 有 的 setVisibitLity 方 法 控制 占 位 视图 的 
显示 。 























SQLite 数 据 库 








几乎 所 有 应 用 都 有 持久 化 保存 数据 的 需要 。 临 时 性 存储 savedInstanceState 显 然 无 法 胜 
任 。 为 此 ，Android 提 供 了 长 期 存储 地 : 手机 或 平板 设备 内 存 上 的 本 地 文件 系统 。 

Android 设 备 上 的 应 用 都 有 一 个 沙 金 目录 。 将 文件 保存 在 沙 盒 中 ， 可 阻止 其 他 应 用 甚至 是 设 
备用 户 的 访问 和 神探 。( 当然 ， 如 果 设 备 被 root 了 的 话 ， 用 户 就 可 以 为 所 欲 为 。) 

应 用 的 沙 盒 目 录 是 /data/data/[ 应 用 的 包 名 称 ]。 例 如 ，CriminalIntent 应 用 的 沙 盒 目 录 是 
/data/data/com.bignerdranch.android.criminalintent。 

需要 保存 大 量 数据 时 ， 大 多 数 应 用 都 不 会 使 用 类 似 txt 这 样 的 普通 文件 。 原因 很 简单 : 假设 将 
crime 记 录 写 入 了 这 样 的 文件 ， 在 仅 需 要 修改 crime 标 题 时 ， 就 得 首先 读 取 整个 文件 的 内 容 ， 完 成 
修改 后 再 全 部 保存 。 数 据 量 大 的 话 ， 这 将 非常 耗 时 。 

怎么 办 呢 ? 有 请 SQLite 登 场 。SQLite 是 类 似 于 MySQL 和 PostgreSQL 的 开源 关系 型 数据 库 。 不 
同 于 其 他 数据 库 的 是 ，SQLite 使 用 单个 文件 存储 数据 , 读 写 数据 时 使 用 SQLite 库 。Android 标 准 库 
包含 SQLite 库 以 及 配套 的 一 些 Java 辅 助 类 。 

本 章 , 我 们 仪 学 习 如 何 运用 SQLite 基 本 辅助 类 , 打开 应 用 沙 盒 中 的 数据 库 , 读 取 或 写 人 数据 。 
知 需 深入 学 习 ， 请 访问 网 站 www.sqlite.orfg ， 阅 读 SQLite 完 全 使 用 手册 。 


















































14.1 定义 schema 


创建 数据 库 前 ， 首 先 要 清楚 存储 什么 样 的 数据 。CriminalIntent 应 用 要 保存 的 是 一 条 条 crime 
记录 ， 这 需要 定义 如 图 14-1 所 示 的 crimes 数 据 表 。 




















CT 
13690636733242 | Stolen yogurt | 13090636733242 
13890732131989 13090732131909 


图 14-1 crimes 数 据 表 

定义 schema 的 方式 众多 ， 如 何 选择 往往 因 人 而 异 。 但 所 有 方式 都 有 一 个 共同 的 目标 :“ 不 要 

重复 造 轮子 。” 实 际 上 , 这 也 是 人 人 都 应 遵守 的 编程 准则 : 多 花 时 间 思 考 复 用 代码 的 编写 和 调用 ， 
避免 在 应 用 中 到 处 使 用 重复 代码 。 
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使 用 数据 库 也 是 如 此 。 面 对 众多 工具 ， 你 甚至 可 以 用 上 能 统一 定义 模型 层 对 象 (如 Crime ) 
的 高 级 ORM ( 对 象 关系 映射 )。 不 过 ， 简 单 起 见 ， 对 于 CriminalIntent 应 用 ， 我 们 打算 直接 在 Java 
代码 中 定义 database schema ( 描述 表 名 和 数据 字段 )。 

首先 创建 定义 schema 的 Java 类 。 将 其 命名 为 CrimeDbSchema， 同时 在 新 建 类 对 话 框 中 输入 包 
名 database.CrimeDbSchema。 这 样 ， 就 可 以 将 CrimeDbSchema.java 文 件 放 入 专门 的 database 包 中 ， 
实现 数据 库 相 关 代码 的 统一 组 织 和 归 类 。 

在 CrimeDbSchema 类 中 ， 再 定义 一 个 描述 数据 表 的 CrimeTable 内 部 类 ， 如 代码 清单 14-1 
所 示 。 


代码 清单 14-1 定义 CrimeTable 内 部 类 ( CrimeDbSchema.java) 


public class CrimeDbSchema { 
public static final class CrimeTable { 
public static final String NAME = "crimes"; 














} 
} 


CrimeTable 内 部 类 唯一 的 用 途 就 是 定义 描述 数据 表 元 素 的 String 常 量 。 它 的 首 个 定义 是 数 
据 库 表 和 名 ( CrimeTable .NAME )。 
接 下 来 定义 数据 表 字 段 ， 如 代码 清单 14-2 所 示 。 


代码 清单 14-2 定义 数据 表 字 段 ( CrimeDbSchema.java ) 


public class CrimeDbSchema { 
public static final class CrimeTable { 
public static final String NAME = "crimes"; 








public static final class Cols { 
public static final String UUID = "uuid"; 
public static final String TITLE = "title"; 
public static final String DATE = "date"; 
public static final String SOLVED = "solved"; 

} 

} 
} 


有 了 这 些 数据 表 元 素 , 就 可 以 在 Java 代 码 中 安全 地 引用 了 。 例如 ,CrimeTable.Cols.TITLE 4 
就 是 指 crime 记 录 的 tite 字 段 。 此 外 ， 这 还 给 修改 字段 名 称 或 新 增 表 元 素 带 来 了 方便 。 


14.2 ”创建 初始 数据 库 


有 了 数据 库 schema, 就 可 以 创建 数据 库 了 了 。open0OrCreateDatabase(...) 和 databaseList() 
是 Android 提 供 的 Context 底 层 方法 ， 用 来 打开 数据 库 文件 并 将 其 转换 为 SQLiteDatabase 实 例 。 

不 过 ， 实 践 中 ， 建 议 总 是 遵循 以 下 步 又。 

(1) 确认 目标 数据 库 是 否 存 在 。 

(2) 如 果 不 存 在 ， 首 先 创建 数据 库 ， 然 后 创建 数据 表 并 初始 化 数据 。 
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(3) 如 果 存 在 , 打开 并 确认 CrimeDbSschema 是 否 为 最 新 ( CriminalIntent 后 续 版 本 可 能 有 改动 )。 

(4) 如 果 是 旧版 本 ， 就 先 升 级 到 最 新 版 本 。 

以 上 工作 可 借助 Android 的 SQLite0penHeLper 类 处 理 。 在 数据 库 包 中 创建 CrimeBaseHeLper 
类 ， 如 代码 清单 14-3 所 示 。 


代码 清单 14-3 ”创建 CrimeBaseHelper 类 ( CrimeBaseHelper.java ) 


public class CrimeBaseHelper extends SQLite0penHeLper { 
private static final int VERSION = 1; 
private static final String DATABASE NAME = "crimeBase.db"; 





public CrimeBaseHelper(Context context) { 
super(context, DATABASE NAME, null, VERSION); 
} 


@Override 
public void onCreate(SQLiteDatabase db) { 


} 


@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 


} 
} 


有 了 SQLite0penHeLper 类 ， 打 开 SQLiteDatabase 的 繁杂 工作 就 简单 多 了 。 在 CrimeLab 中 
用 它 创建 crime 数 据 库 ， 如 代码 清单 14-4 所 示 。 


代码 清单 14-4 打开 SQLiteDatabase ( CrimeLab.java) 


public class CrimeLab { 
private static CrimeLab sCrimeLab; 





private List<Crime> mCrimes; 
private Context mContext; 
private SQLiteDatabase mDatabase; 


private CrimeLab(Context context) { 
mContext = context.getApplicationContext(); 
mDatabase = new CrimeBaseHelper (mContext) 
.getWwritableDatabase(); 
mCrimes = new ArrayList<>(); 


} 
(你 可 能 会 问 ， 为 什么 要 把 context 赋 值 给 实例 变量 呢 ? 不 要 奇怪 ，CrimeLab 会 在 第 16 章 用 到 


它 。) 
调用 getWritabLeDatabase() 方 法 时 ，CrimeBaseHeLper 会 做 如 下 工作 。 
(1) 打开 /data/data/com.bignerdranch.android.criminalintent/databases/crimeBase.db 数 据 库 ; 如 果 


不 存在 ， 就 先 创 建 crimeBase.db 数 据 库 文件 。 
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(2) 如 果 是 首次 创建 数据 库 ， 就 调用 onCreate(SQLiteDatabase) 方 法 ， 然 后 保存 最 新 的 版 
本 号 。 

(3) 如 果 已 创建 过 数据 库 ， 首 先 检查 它 的 版 本 号 。 如 果 CrimeBaseHelper 中 的 版 本 号 更 高 ， 
就 调用 onUpgrade (SQLiteDatabase，int，int) 方 法 升级 。 

最 后 做 个 总 结 : onCreate(SQLiteDatabase) 方 法 负责 创建 初始 数据 库 ; onUpgrade- 
(SQLiteDatabase，int，int) 方 法 负责 与 升级 相关 的 工作 。 

CriminalImntent 当 前 只 有 一 个 版 本 ， 暂 时 可 以 忽略 onUpgrade(...) 方 法 。 目 前 ， 只 需要 在 
onCreate(.,. ) 方 法 中 创建 数据 表 。 这 需要 导入 CrimeDbSchema 类 的 CrimeTable 内 部 类 。 

导入 分 两 步 完 成 。 首 先 ， 编 写 SQL 创 建 初始 代码 ， 如 代码 清单 14-5 所 示 。 


代码 清单 14-5 ”编写 SQL 创建 初始 代码 ( CrimeBaseHelper.java ) 


@Override 
public void onCreate(SQLiteDatabase db) { 
db .execSQL("create table " + CrimeDbSchema.CrimeTable.NAME); 





























} 





I 


巴 光标 移 到 CrimeTabtLe 一 词 上 ， 按 Option+Return ( 或 Alt+Enter ) 组 合 键 ， 然 后 选择 提示 里 
的 Add import for 'com.bignerdranch.android.criminalintent.database.CrimeDbSchema.CrimeTable' 可 
选项 ， 如 图 14-2 所 示 。 








or 





Yema. CrimeTable. NAME); 
# Add import for ‘com.bignerdranch.android.criminalintent.database.CrimeDbSchema.CrimeTable' 





好 Add on demand static import for 'com.bignerdranch.android.criminalintent.database.CrimeDbSchema.CrimeTable'» 
ww oldVersio 人 3S? Copy String concatenation text to the clipboard 

光 Replace '+' with 'String.format()' 

区 Replace '+' with 'StringBuilder.appendO' 

区 Replace '+' with 'java.text.MessageFormat.format()' 





图 14-2 导入 CrimeTable 


Android Studio 会 自动 产生 如 下 导入 语句 : 


import com.bignerdranch.android.criminalintent.database.CrimeDbSchema.CrimeTable; 


public class CrimeBaseHelper extends SQLiteOpenHelper { 4 


这 样 , 与 其 费事 地 输入 CrimeDbSchema.CrimeTable.Cols.UUID, 还 不 如 直接 以 CrimeTable. 
Cols .UUID 的 形式 使 用 CrimeDbSchema .CrimeTable 中 的 String 常 量 。 完成 其 余 表 定义 代码 , 如 
代码 清单 14-6 所 示 。 


代码 清单 14-6 ”创建 crime 数 据 表 ( CrimeBaseHelperjava ) 


@Override 
public void onCreate(SQLiteDatabase db) { 
db.execSQL("create table " + CrimeTable.NAME + "("+ 
" _id integer primary key autoincrement, "+ 
CrimeTable.Cols.UUID + ", "+ 
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CrimeTable.Cols.TITLE + ", "+ 
CrimeTable.Cols.DATE + ", "+ 
CrimeTable.Cols.SOLVED + 
")" 
); 
} 
相 比 其 他 数据 库 , 创建 SQLite 数 据 库 表 省 事 又 简单 : 创建 表 字 段 时 , 不 需要 指定 表 字段 类 型 。 
运行 CriminalIntent 应 用 后 ， 数 据 库 将 被 创建 。 如 果 在 用 模拟 器 或 是 已 root 的 设备 ， 可 直接 看 
到 已 创建 的 数据 库 文 件 。 
写作 本 书 时 ，Nougat ( API 24 或 25 ) 模拟 器 镜像 无 法 配合 Android Device Monitor 文 件 浏 览 器 
使 用 。 要 看 到 刚 创建 的 文件 ， 你 需要 使 用 旧版 本 的 模拟 器 安装 并 运行 应 用 。 












































14.2.1 使 用 Android Device Monitor 查看 文件 


改 用 旧版 本 模拟 器 后 ， 请 选择 Tools 一 Android 一 Android Device Monitor 菜 单项 ， 如 果 看 到 要 
求 禁用 ADB 整 合 的 对 话 框 ， 请 选 Yes， 如 图 14-3 所 示 。 


Disable ADB Integration 
4 Following debug sessions will be closed: 


全 SpE 








No | BG 


图 14-3 ”禁用 ADB 整 合 


等 Android Device Monitor 窗 口 弹 出 后 ， 选 择 File Explorer 选 项 页 。 浏 览 至 /data/data/com. 
bignerdranch.android.criminalintent/databases/ 卓 录 ， 即 可 看 到 CriminalIntent 刚 创建 的 数据 库 文 件 ， 
如 图 14-4 所 示 。 



















多 Threads Heap Allocation Tracker | 过 Network Statistics 于 ! File Explorer % 
Name Size Date 

F [FZ com.android.wallpaper 2014-12-10 

PF [Scom.android.wallpaper.holospiral 2014-12-10 

P [Scom.android.wallpaper.livepicker 2014-12-10 

PF [Scom.android.wallpapercropper 2014-12-10 

PF [Scom.android.webview 2014-12-10 

PF [Scom.bignerdranch.android.beatbox 2015-01-19 

VY [Scom.bignerdranch.android.criminalintent 2015-02-05 

P [Scache 2015-02-05 

钨 databases 2015-02-05 

司 crimeBase.db 20480 2015-02-05 

司 crimeBase.db-journal 8720 2015-02-05 

站 lib 2015-02-05 





图 14-4 ”数据 库 文件 已 生成 
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(禁用 ADB 整 合 后 ， 如 果 运 行 应 用 ， 你 会 看 到 Instant Run requires 'Tools | Android | Enable ADB 
integration' to be enabled 这 样 的 错误 提示 。 要 解决 这 个 问题 ， 请 选择 Android Studio 一 Preferences 
菜单 项 , 在 弹出 的 首选 项 界面 的 左上 角 输 入 “Instant Run” 搜 索 , 如 图 14-5 所 示 。 然 后 ,去 除 Enable 
Instant Run to hot swap code/resource changes on deploy (default enabled) 选 项 ， 点 选 Apply 按 钮 应 用 并 
点 OK 按钮 完成 。) 





@e®@ Preferences 
Q Instant Run @ Build,Execution, Deployment > Instant Run Reset 
YY Appearance & Behavior Enable Instant Run to hot swap code/resource changes on deploy (default enabled) 
Notifications v Restartactivity on code changes 
Y Editor v Show toasts in the running app when changes are applied 
Inspections 允 Show Instant Run status notifications 
Intentions Log extra info to help Google troubleshoot Instant Run issues (Recommended) 


v Build, Execution, Deployment 


Learn more about what is logged, and our privacy policy. 





Instant Run UI Option 1 同 





Having trouble with Instant Run? 


We want to make Instant Run perfect, but we need more info about your project to investigate issues. 
Please help us troubleshoot and fix Instant Run issues by doing the following: 


1. Re-enable Instant Run and activate extra logging 
2. Reproduce the Instant Run issue 
3. Immediately after reproducing the issue, click Help | Report Instant Run Issue... to send us the issue report. 








Re-enable and activate extra logging 








Cancel Appy | LI 





图 14-5 ”禁用 Instant Run 


14.2.2 ”处 理 数据 库 相 关 问 题 


编写 SQLite 数 据 库 操作 代码 时 ， 经 常会 碰 到 要 调整 数据 库 表 结构 的 情况 。 例 如 ,我 们 还 要 在 
后 续 章 节 中 添加 crime 嫌 疑 人 。 这 就 需要 为 crime 数 据 表 新 增 字 段 。 处 理 时 ， 比 较 常 规 的 做 法 是 ， 
在 SQLite0penHelper 中 记录 版 本 号 ， 然 后 在 onUpgrade(.,. ) 方 法 中 升级 数据 表 。 

这 种 常规 方法 涉及 不 少 代 码 量 。 而 且 , 编写 和 维护 很 少 更 新 版 本 的 代码 也 很 伤 脑筋 。 所以， 
实践 中 ， 最 好 的 做 法 是 直接 删除 数据 库 文件 ， 再 让 SQLite0penHelper.onCreate(...) 方 法 4 
重建 。 
直接 从 设备 上 删除 应 用 是 删除 数据 库 文件 最 便捷 的 方法 。 要 在 模拟 器 上 删除 应 用 , 可 以 切换 
到 应 用 浏览 器 界面 ,向 上 拖 动 CriminalIntent 应 用 的 图 标 ， 直 到 屏幕 顶部 出 现 Uninstall 字 样 ( 注意 ， 
不 同 Android 版 本 的 操作 可 能 有 所 差别 )。 执 行 并 确认 删除 应 用 ， 如 图 14-6 所 示 。 
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Criminallintent 


Do you want to uninstall this app? 


CANCEL OK 





图 14-6 ”删除 应 用 
记 住 ， 在 学 习 本 章 的 过 程 中 ， 如 遇 数 据 库 相 关 问 题 ， 都 建议 直接 删除 应 用 ， 从 头 再 来 。 


14.3 ”修改 CrimeLab 类 


创建 完 数据 库 ， 接 下 来 是 调整 CrimeLab 类 代码 ， 改 用 mDatabase 存 储 数 据 。 
首先 要 删除 CrimeLab 中 所 有 与 nCrimes 相 关 的 代码 ， 如 代码 清单 14-7 所 示 。 


代码 清单 14-7 ”删除 mCrimes 相 关 代 码 ( CrimeLab.java ) 


public class CrimeLab { 
private static CrimeLab sCrimeLab; 

















private List<Crime> mCrimes; 
private Context mContext; 
private SQLiteDatabase mDatabase; 





public static CrimeLab get(Context context) { 
} 
private CrimeLab(Context context) { 


mContext = context.getApplicationContext(); 
mDatabase = new CrimeBaseHelper(mContext) 
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.getWritableDatabase(); 
mCrimes = new AFFayList<> 人 (地 





} 


public void addCrime(Crime c) { 
mcrimes-add (ce}); 
} 


public List<Crime> getCrimes() { 
Feturn mCrimes; 
return new ArrayList<>(); 


} 


public Crime getCrime(UUID id) { 
for (Crime erime : mCrimes}) { 
i (eri Tdg 1Ls(id)) { 
return crime; 





} 
+ 


return null; 


. 


代码 调整 完毕 。 运 行 CriminalIntent 应 用 时 ， 只 会 看 到 空 列 表 和 空 CrimePagerActivity。 没 
关系 ， 下 面 就 来 逐步 完善 它 。 


14.4 写 入 数据 库 


要 使 用 SQLiteDatabase， 首 先 要 有 数据 。 数 据 库 写 人 操作 有 : 向 crime 表 中 插入 新 记录 以 及 
在 Crime 变 更 时 更 新 原始 记录 。 








14.4.1 使 用 ContentVaLues 


负责 处 理 数 据 库 写 人 和 更 新 操作 的 辅助 类 是 ContentVatLues 。 它 是 一 个 键 值 存 储 类 , 类 似 于 
Java 的 HashMap 和 前 面 用 过 的 BundLe。 不 同 的 是 ，ContentVaLues 只 能 用 于 处 理 SQLite 数 据 。 

将 Crime 记 录 转 换 为 ContentValues, 实际 就 是 在 CrimeLab 中 创建 ContentValues 实 例 。 这 
需要 新 建 一 个 私有 方法 ， 如 代码 清单 14-8 所 示 。( 记得 使 用 前 述 的 两 个 步 又 导入 CrimeTabtLe: 把 
光标 定位 到 CrimeTabtLe.Cots.UUID 上 ， 按 Option+Return (或 Alt+Enter ) 组 合 键 ， 然 后 选择 提示 
里 的 Add import for 'com.bignerdranch.android.criminalintent.database.CrimeDbSchema.CrimeTable' 
可 选项 。) 


代码 清单 14-8 ”创建 ContentValues (CrimeLab.java ) 


public Crime getCrime(UUID id) { 
return null; 











} 


private static ContentValues getContentValues(Crime crime) { 
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ContentValues values = new ContentValues(); 
values.put(CrimeTable.Cols.UUID, crime.getId().toString()); 
values.put(CrimeTable.Cols.TITLE, crime.getTitle()); 
values.put(CrimeTable.Cols.DATE, crime.getDate().getTime()); 
values.put(CrimeTable.Cols.SOLVED, crime.isSolved() ? 1 : 0); 


return values; 


} 
ContentValues 的 键 就 是 数据 表 字段 。 注 意 不 要 搞 错 ， 否 则 会 导致 数据 插入 和 更 新 失败 。 除 
了 _id 是 由 数据 库 自动 创建 外 ， 其 他 所 有 数据 表 字 上 段 都 要 编码 指定 。 
14.4.2 ”插入 和 更 新 记录 
准备 好 ContentValues ,就 该 向 数据 库 写 入 数据 了 ,参照 代码 清单 14-9, 在 addCrime (Crime) 
方法 中 新 增 数据 插入 实现 代码 。 
代码 清单 14-9 插入 记录 ( CrimeLab.java) 


public void addCrime(Crime c) { 
ContentValues values = getContentValues(c); 






































mDatabase.insert(CrimeTable.NAME, null, values); 


} 

insert(String，String，ContentVatues ) 方 法 的 第 一 和 第 三 个 参数 很 重要 ， 第 二 个 很 少 
用 到 。 传 入 的 第 一 个 参数 是 数据 表 名 (CrimeTabtLe .NAME )， 第 三 个 是 要 写 入 的 数据 。 

第 二 个 参数 称 为 nuLLCoLumnHack。 它 有 什么 用 途 呢 ? 

别 急 ， 举 个 例子 你 就 明白 了 。 假设 你 想 调 用 insert(...) 方 法 , 但 传人 了 ContentValues 
空 值 。 这 时 ，SQLite 不 干 了 ，insert(.,.) 方 法 调用 只 能 以 失败 告终 。 

然而 ， 如 果 能 以 uuid 值 作为 nuLLCoLumnHack 传 人 的 话 ，SQLite 就 可 以 忽略 ContentVatLues 
空 值 ， 而 且 还 会 自动 传人 一 个 带 uuid 晶 值 为 hull 的 ContentValues。 结 果 ，insert(...) 方 法 
得 以 成 功 调用 并 插入 了 一 条 新 记录 。 

听 起 来 不 错 吧 ， 也 许 某 天 会 用 得 着 ,但 肯定 不 是 现在 。 因 此 ， 目 前 只 要 了 解 就 可 以 了 。 

完成 了 数据 插入 ， 下 面 继 续 使 用 ContentValues， 新 增 数据 库 记 录 更 新 方法 ， 如 代码 清单 
14-10 所 示 。 






































代码 清单 14-10 ”更 新 记录 ( CrimeLab.java ) 


public Crime getCrime(UUID id) { 
return null; 


} 


public void updateCrime(Crime crime) { 
String uuidString = crime.getId().toString(); 
ContentValues values = getContentValues (crime); 
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mDatabase,update(CrimeTabLe.NAME，vaLues， 
CrimeTabLe.CoLs.UUID + " = ?"， 
new String[] { uuidString }); 
} 


private static ContentValues getContentValues(Crime crime) { 


update(String，ContentValues，String，String[]) 方 法 类 似 于 insert(..,.,) 方 法 ， 
向 其 传人 要 更 新 的 数据 表 名 和 为 表 记 录 准 备 的 ContentValues。 然而 , 与 insert(,..,) 方 法 不 同 
的 是 , 你 要 确定 该 更 新 哪些 记录 。 具体 的 做 法 是 : 创建 where 子 句 ( 第 三 个 参数 ), 然后 指定 where 
子 句 中 的 参数 值 (String[] 数 组 参数 )。 

问题 来 了 ， 为 什么 不 直接 在 where 子 句 中 放 入 uuidString 呢 ?这 可 比 使 用 ?然后 传人 
String[] 简 单 多 了 ! 

事实 上 ， 很 多 时 候 ，String 本 身 会 包含 SQL 代码 。 如 果 将 它 直 接 放 和 人 query 语 句 中 ， 这 些 代 
码 可 能 会 改变 query 语 句 的 含义 ,甚至 会 修改 数据 库 资料 。 这 实际 就 是 SQL 脚本 注入 , 其 危害 相当 
严重 。 
使 用 ?的 话 ， 就 不 用 关心 String 包 含 什 么 ， 代 码 执行 的 效果 肯定 就 是 我 们 想 要 的 。 因 此 ， 建 
议 你 保持 这 种 良好 的 编码 习惯 。 

用 户 可 能 会 在 CrimeFragment 中 修改 Crime 实 例 。 修 改 完成 后 ， 你 需要 刷新 CrimeLab 中 的 
Crime 数 据 。 这 可 以 通过 覆盖 CrimeFragment .onPause() 方 法 完成 ， 如 代码 清单 14-11 所 示 。 
























































代码 清单 14-11 Crime 数 据 刷 新 ( CrimeFragment.java ) 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 
UUID crimeId = (UUID) getArguments().getSerializable(ARG CRIME ID); 
mCrime = CrimeLab.get(getActivity()).getCrime(crimeId) ; 

} 


@Override 
public void onPause() { 
super.onPause(); 


CrimeLab.get(getActivity()) 
.UpdateCrime (mCrime); 


} 
数据 库 写 入 部 分 处 理 完了 。 不过， 要 检验 成 果 ， 得 等 到 数据 库 读 取 也 处 理 完 。 继 续 之 前 ， 运 
行 CriminalIntent 应 用 看 看 代码 能 否 正常 编译 。 一 切 正常 的 话 ， 你 应 该 看 到 一 个 crime 空 列表 。 


14.5 ” 读 取 数据 库 


读 取 数据 需要 用 到 SQLiteDatabase.query(...) 方 法 。 这 个 方法 有 好 几 个 重 载 版 本 。 我 们 
要 用 的 版 本 如 下 : 
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public Cursor query( 
String table, 
String[] columns, 
String where, 
String[] whereArgs, 
String groupBy, 
String having, 
String orderBy, 
String limit) 


以 前 写 过 SQL 代 码 的 话 , 你 应 该 已 经 熟 


眼前 要 用 的 就 好 了 。 


public Cursor query( 
String table, 
String[] columns, 
String where, 
String[] whereArgs, 
String groupBy, 
String having, 
String orderBy, 
String limit) 














末 } 


1DA 


这 些 seLect 语 名 参数 了 。 不 熟悉 也 没关系 ,只 关注 


参数 table 是 要 查询 的 数据 表 。 参 数 columns 指 定 要 依次 获取 哪些 字段 的 值 。 参 数 where 和 
whereArgs 的 作用 与 update(... ) 方 法 中 的 一 样 。 








新 增 一 个 便利 方法 ,调用 query(.. .) 方 法 查询 CrimeTable 中 的 记录 ,如 代码 清单 14-12 所 示 。 





代码 清单 14-12 ”查询 crime 记 录 ( CrimeLab.java ) 


public void updateCrime(Crime crime) { 


} 


private Cursor queryCrimes(String whereClause, String[] whereArgs) { 


Cursor cursor = mDatabase.query( 


CrimeTabLe.NAME， 


nuLL，// Columns - nuLL selects all coLumns 


whereClause, 

whereArgs, 

null, // groupBy 

null, // having 

null // orderBy 
); 


return cursor; 


14.5.1 使 用 CursorWrapper 


Cursor 是 个 神奇 的 表 数 据 处 理工 具 。 其 功 























取 数 据 的 代码 大 致 如 下 : 


bE 就 是 封装 数据 表 中 的 原始 字段 值 。 从 Cursor 获 
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String uuidString = cursor.getString( 
cursor.getColumnIndex(CrimeTable.Cols.UUID)); 
String title = cursor.getString( 
cursor.getColumnIndex(CrimeTable.Cols.TITLE)); 
Long date = cursor.getLong( 
cursor.getColumnIndex(CrimeTable.Cols.DATE)); 
int isSolved = cursor.getInt( 
cursor.getColumnIndex(CrimeTable.Cols.SOLVED)); 


每 从 Cursor 中 取出 一 条 crime 记 录 , 以 上 代码 都 要 重复 写 一 次 。( 这 还 不 包括 按照 这 些 字段 值 
创建 Crime 实 例 的 代码 。) 

显然 ， 遇 到 这 种 情况 ， 首 先 要 考虑 代码 复 用 。 与 其 机 械 地 编写 重复 代码 ， 2 
专用 Cursor 子 类 。 创 建 Cursor 子 类 最 简单 的 方式 是 使 用 CursorWrapper。 顾 名 思 义 ， 你 可 以 用 
CursorWrapper 封 装 Cursor 的 对 象 ， 然 后 再 添加 有 用 的 扩展 方法 。 

在 数据 库 包 中 新 建 CrimeCursorWrapper 类 ， 如 代码 清单 14-13 所 示 。 



























































代码 清单 14-13 ”创建 CrimeCursorWrapper 类 (CrimeCursorWrapper.java ) 


public class CrimeCursorWrapper extends CursorWrapper { 
public CrimeCursorWrapper(Cursor cursor) { 
super(cursor); 
} 
} 
以 上 代码 创建 了 一 个 Cursor 封 装 类 。 该 类 继承 了 Cursor 类 的 全 部 方法 。 注 意 ， 这 样 封 装 的 
目的 就 是 定制 新 方法 ， 以 方便 操作 内 部 Cursor。 
参照 代码 清单 14-.14， 新 增 获取 相关 字段 值 的 getCrime() 方 法 。( 别 忘 了 前 面 介 绍 的 两 步 导 
入 CrimeTable 的 技巧 。) 














代码 清单 14-14 ”新 增 getCrime() 方 法 ( CrimeCursorWrapper.java ) 


public class CrimeCursorWrapper extends Cursorwrapper { 
public CrimeCursorWrapper(Cursor cursor) { 
super(cursor); 


} 


public Crime getCrime() { 
String uuidString = getString(getColumnIndex (CrimeTable.Cols .UUID)); 
String title = getString(getColumnIndex(CrimeTable.Cols.TITLE)); 
Long date = getLong(getColumnIndex(CrimeTable.Cols .DATE)); 
int isSolved = getInt(getColumnIndex(CrimeTable.Cols.SOLVED)); 





return null; 


} 


我 们 需要 返回 具有 UUID 的 Crime。 在 Crime.java 中 新 增 一 个 有 此 用 途 的 构造 方法 ， 如 代码 清 
单 14-15 所 示 。 
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代码 清单 14-15 ”新 增 Crime 构 造 方法 ( Crime.java) 


public Crime() { 
this (UUID.randomUUID()); 


mId = UUID, randomUUID (); 
mpate -= new Date(); 

} 

public Crime(UUID id) { 
mId = id; 
mDate = new Date(); 


} 


最 后 ， 完 成 getCrime() 方 法 ， 如 代码 清单 14-16 所 示 。 


代码 清单 14-16 ”完成 getCrime() 方 法 ( CrimeCursorWrapper.java ) 


public Crime getCrime() { 
String uuidString = getString(getColumnIndex(CrimeTable.Cols.UUID)); 
String title = getString(getColumnIndex(CrimeTable.Cols.TITLE)); 
long date = getLong(getColumnIndex(CrimeTable.Cols.DATE)); 
int isSolved = getIint(getColumnIndex(CrimeTable.Cols.SOLVED)); 


Crime 
crime 


crime = new Crime(UUID.fromString(uuidString)); 


.SetTitle(title); 
crime. 
crime. 


setDate(new Date(date)); 
setSolved(isSolved != 0); 


return crime; 


teturn nutt; 


} 
































( Android Studio 会 询问 是 选择 java.util.Date 还 是 java.sql.Date。 不 要 搞 错 ， 即 便 现 在 


























是 在 编写 数据 库 相 关 代码 ， 也 应 该 选 java .util.Date。) 


14.5.2 ”创建 模型 层 对 象 
使 用 CrimeCursorWrapper 类 , 可 直接 从 CrimeLab 中 取得 List<Crime>。 大 致 思路 无 外 乎 将 














查询 返回 的 cursor 封 装 到 CrimeCursorWrapper 类 中 , 然后 调用 getCrime () 方 法 遍历 取出 Crime。 


首先 ， 让 queryCrimes(.,.) 方 法 返回 CrimeCursorWrapper 对 象 ， 如 代码 清单 14-17 所 示 。 


代码 清单 14-17 使 用 Cursor 封 装 方法 ( CrimeLab.java ) 
private Cursor queryCrimes (String whereCtlause, String[] whereArgs) { 








private CrimeCursorWrapper queryCrimes(String whereClause, String[] whereArgs) { 
Cursor cursor = mDatabase.query( 


CrimeTable.NAME, 

null, // Columns - null selects all columns 
whereClause, 

whereArgs, 

null, // groupBy 

null, // having 
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null // orderBy 
); 


Teturn eursers; 
return new CrimeCursorWrapper(cursor); 


} 


然后 ， 完 善 getCrime() 方 法 : 遍历 查询 取出 所 有 的 crime， 返 回 Crime 数 组 对 象 ， 如 代码 清 
单 14-18 所 示 。 


代码 清单 14-18 返回 crime 列 表 〈 CrimeLab.java ) 
public List<Crime> getCrimes() { 
return new ArrayList<>(); 
List<Crime> crimes = new ArrayList<>(); 








CrimeCursorWrapper cursor = queryCrimes(null, null); 


try { 
cursor.moveToFirst(); 
while (!cursor.isAfterLast()) { 
crimes.add(cursor.getCrime()); 
cursor.moveToNext(); 


} 
} finally { 
cursor.close(); 


} 


return crimes; 


} 

数据 库 cursor 之 所 以 被 称 为 cursor, 是 因为 它 内 部 就 像 有 根 手 指 似 的 , 总 是 指 问 查询 的 某 个 地 
方 。 因 此 ， 要 从 cursor 中 取出 数据 ， 首 先 要 调用 moveToFirst ( ) 方 法 移动 虚拟 手指 指向 第 一 个 元 
素 。 读 取 行 记录 后 ， 再 调用 moveToNext ( ) 方 法 ， 读 取 下 一 行 记 录 ， 直 到 isAfterLast () 说 没有 
数据 可 取 为 止 。 

最 后 , 别 忘 了 调用 Cursor 的 cLose( ) 方 法 关闭 它 , 否则 会 出 错 : 轻 则 应 用 报错 , 重 则 应 用 崩 演 。 

CrimeLab.getCrime(UUID) 方 法 类 似 于 getCrimes() 方 法 ， 唯 一 区 别 就 是 ， 它 只 需要 取出 
已 存在 的 首 条 记录 ， 如 代码 清单 14-19 所 示 。 


代码 清单 14-19 重 写 getCrime(UUID ) 方 法 (CrimeLab .java ) 
public Crime getCrime(UUID id) { 





























FetuFn_nuLL 
CrimeCursorWrapper cursor = queryCrimes( 
CrimeTabLe.CoLs.UUID + " = ?", 


new String[] { id.toString() } 
); 


try { 
if (cursor.getCount() == 0) { 
return null; 
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} 


cursor.moveToFirst(); 
return cursor.getCrime(); 
} finally { 
cursor.close(); 
} 
} 


上 述 代码 的 作用 总 结 如 下 。 
口 现在 可 以 插入 crime 记 录 了 。 也 就 是 说 ， 点 击 New Crime 菜 单项 ,将 Crime 添 加 到 
CrimeLab 的 代码 可 以 工作 了 。 
口 数据 库 查 询 没 有 问题 了 。CrimePagerActivity 现 在 能 够 看 见 CrimeLab 中 的 所 有 Crime 了 。 
口 CrimeLab.getCrime(UUID) 方法 也 能 正常 工作 了 。CrimePagerActivity 托管 的 
CrimeFragment 终 于 可 以 显示 真正 的 Crime 对 象 了 。 

现在 ， 点 击 New Crime 菜 单项 可 以 在 CrimePagerActivity 界 面 看 到 新 增 的 Crime 了 。 运 人 
CriminalIntent 应 用 确认 。 
刷新 模型 层 数据 
这 还 不 算 完 。 虽然 Crime 记 录 已 存 人 数据 库 , 但 数据 读 取 还 未 完善 。 例 如 ,编辑 完 新 的 crime 
尝试 点 击 后 退 键 ， 你 会 发 现 CrimeListActivity 并 没有 相应 刷新 。 
这 是 因为 CrimeLab 的 工作 方式 已 经 变 了 。 以 前 ， 只 有 一 个 List<Crime> ， 而 且 每 个 Crime 
在 List<Crime> 中 只 存 有 一 个 对 象 。 要 获取 哪个 Crime 只 能 去 找 mCrimes。 

现在 ，mCrimes 已 废弃 不 用 。 所 以 ，getCrimes() 方 法 返回 的 List<Crime> 是 Crime 对 象 的 
快照 。 要 刷新 CrimeListActivity 界 面 ， 首 先 要 更 新 这 个 快照 

好 在 大 部 分 基础 工作 已 经 就 绪 。 rinel Tetact vit () 方 法 来 刷新 界面 。 
剩 下 的 事情 就 是 刷新 CrimeLab 的 视图 了 。 

要 刷新 crime 显 示 ， 首 先 添 加 一 个 setCrimes(List<Crime>) 方 法 给 CrimeAdapter， 如 代码 
清单 14-20 所 示 。 


代码 清单 14-20 添加 setCrimes(List<Crime>) 方 法 (CrimeListFragment.java ) 


private class CrimeAdapter extends RecyclerView.Adapter<CrimeHolder> { 




















后 


























@Override 
public int getItemCount() { 
return mCrimes.size(); 


} 


public void setCrimes(List<Crime> crimes) { 
mCrimes = crimes; 
} 
} 
然后 在 updateUI() 方 法 中 调用 setCrimes (List<Crime>) 方 法 ， 如 代码 清单 14-21 所 示 。 


和 
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代码 清单 14-21 调用 setCrimes(List<Crime>) 方 法 (CrimeListFragment,java ) 


private void updateUI() { 
CrimeLab crimeLab = CrimeLab.get(getActivity()); 
List<Crime> crimes = crimeLab.getCrimes(); 


if (mAdapter == nuLL) { 
mAdapter = new CrimeAdapter(crimes); 
mCrimeRecyclerView.setAdapter (mAdapter); 
} else { 
mAdapter .setCrimes (crimes); 
mAdapter.notifyDataSetChanged(); 
} 


updateSubtitle(); 
} 


现在 , 可 以 验证 我 们 的 成 果 了 。 运行 CriminalIntent 应 用 , 新 增 一 项 crime 记 录 , 然后 按 后 退 键 ， 
确认 CrimeListActivity 中 会 出 现 刚才 新 增 的 记录 。 

此 外 ,还 建议 验证 CrimeFragment 中 的 updateCrime(Crime) 方 法 的 调用 是 否 正常 。 点 击 任 
意 crime 列 表 项 , 在 CrimePagerActivity 中 编辑 它 的 标题 。 然 后 按 后 退 键 , 确认 对 应 列表 项 的 标 
题 会 更 新 。 


14.6 ”深入 学 习 : 数据 库 高 级 主题 介绍 


为 了 简化 教学 及 控制 篇 幅 , 本 章 没 有 讨论 数据 库 应 用 的 方方面面 。 要 知道 , 很 多 专业 应 用 都 
需要 高 级 数据 库 使 用 支持 。 为 了 提高 开发 效率 ， 人 们 常常 会 求助 于 ORM 这 样 专业 又 复杂 的 工具 。 
开发 复杂 的 数据 库 应 用 时 ， 难 免 会 需要 以 下 数据 库 元 素 。 
口 字段 类 型 。 从 技术 实现 上 讲 ，SQLite 的 字段 不 需要 指定 数据 类 型 。 没 有 它们 完全 不 影 
数据 库 的 使 用 ; 当然 ， 如 果 能 给 出 数据 类 型 提示 会 更 好 。 
口 索引 。 查 询 数据 库 字 段 时 ， 字 上段 不 加 索引 会 严重 影响 查询 性 能 和 效率 。 
口 外 键 。 本 章 的 数据 库 只 用 了 一 张 表 。 如 果 涉 及 多 张 表 ， 关 联 数据 应 该 需要 外 键 约束 。 
数据 库 性 能 优化 需要 考虑 的 因素 众多 。 每 次 查询 数据 库 时 ，CriminalIntent 应 用 都 会 创建 包含 
所 有 Crime 对 象 的 列表 。 要 获得 高 性 能 表现 ， 需 要 采取 一 些 优化 措施 。 比 如 ， 循 环 使 用 Crime 实 
例 ， 或 者 把 它们 当 作 内 存 对 象 。 显 然 ， 这 涉及 更 多 的 代码 量 。 当 然 ， 这 也 是 ORM 这 样 的 专业 工 
具 要 解决 的 问题 。 


14.7 深入 学 习 : 应 用 上 下 文 
本 章 一 开始 ， 我 们 在 CrimeLab 的 构造 方法 中 使 用 了 应 用 上 下 文 。 


private CrimeLab(Context context) { 
mContext = context.getApplicationContext(); 









































可 
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应 用 上 下 文 有 什么 特别 呢 ? 就 上 例 来 看 ， 为 什么 要 用 应 用 上 下 文 ， 而 不 直接 用 activity 作 为 
context 呢 ? 

要 回答 上 述 问题 ， 关 键 就 在 于 考虑 它们 的 生命 周期 。 只 要 有 activity 在 ，Android 肯 定 也 创建 
了 application 对 象 . 用 户 在 应 用 的 不 同 界 面 间 导航 时 ,各 个 activity 时 而 存在 时 而 消亡 ,但 application 
对 象 不 会 受 任何 影响 。 可 以 说 ， 它 的 生命 周期 要 比 任何 activity 都 长 。 

CrimeLab 是 一 个 单 例 。 这 表明 , 一旦 创建 ， 它 就 会 一 直 存 在 ,直至 整个 应 用 进程 被 销毁 。 由 
代码 可 知 ，CrimeLab 引 用 着 mContext 对 象 。 显 然 ， 如 果 把 activity 作 为 mContext 对 象 保存 的 话 ， 
这 个 由 CrimeLab 一 直 引 用 着 的 activity 肯 定 会 免 遭 垃圾 回收 器 的 清理 ， 即 便 用 户 跳 转 离开 这 个 
activity 时 也 是 如 此 。 

为 了 避免 资源 浪费 , 我 们 使 用 了 应 用 上 下 文 。 这 样 ，CrimeLab 仍 可 以 引用 Context 对 象 ， 而 
activity 的 生死 也 不 用 受 它 束缚 了 。 


14.8 ”挑战 练习 : 删除 crime 记录 


如 果 为 应 用 添加 过 Delete Crime 菜 单项 的 话 ， 就 可 以 直接 调用 CrimeLab 的 deleteCrime- 
(Crime) 方 法 ， 继 而 调用 mDatabase.delete(,. .) 方 法 来 实现 删除 功能 。 

如 果 还 没有 ， 那 就 先 给 CrimeFragment 的 工具 栏 添 加 一 个 Delete Crime 菜 单项 ， 然 后 调用 
CrimeLab.deleteCrime (Crime) 方 法 实现 删除 功能 。 































































































隐 式 intent 








在 Android 系 统 中 ， 可 利用 隐 式 intent 启 动 其 他 应 用 的 activity。 在 显 式 intent 中 ,我 们 指定 要 启 
动 的 activity 类 ， 操 作 系 统 会 负责 启动 它 。 在 隐 式 intent 中 ， 我 们 只 要 描述 要 完成 的 任务 ， 操 作 系 
统 就 会 找到 合适 的 应 用 ， 并 在 其 中 启动 相应 的 activity。 

本 章 , 我 们 将 使 用 隐 式 intent 发 送 短 消息 给 Crime 嫌 疑 人 。 用 户 首先 从 某 个 联系 人 应 用 中 选取 
联系 人 ， 然 后 从 短 消 息 应 用 列表 中 选取 目标 应 用 发 送 消息 ， 如 图 15-1 所 示 。 








€ Criminalintent 


TITLE 


Enter a title for the crime. 





DETAILS 


MON DEC 12 11:09:22 EST 2016 











Solved 





CHOOSE SUSPECT 


SEND CRIME REPORT 


打开 联系 人 应 用 














打开 消息 发 送 应 

















图 15-1 打开 联系 人 应 用 和 消息 发 送 应 用 15 


对 于 开发 者 来 说 ， 使 用 隐 式 intent 利 用 其 他 应 用 完成 常见 任务 ， 远 比 自己 编写 代码 从 头 实现 
要 容易 得 多 。 对 于 用 户 来 说 ， 他 们 也 乐意 在 应 用 中 调用 自己 熟悉 或 喜爱 的 应 用 。 

创建 隐 式 intent 之 前 ， 需 完成 以 下 准备 工作 : 
口 在 C rimer ragmentAyi 局 上 添加 CHOOSE SUSPECT 按 钮 和 SEND CRIME REPORT 按 钮 ; 
口 在 Crime 类 中 添加 保存 嫌疑 人 姓名 的 mSuspect 变 量 ，; 
口 使 用 格式 化 的 字符 串 资源 创建 消息 模板 。 
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15.1 添加 按钮 组 件 


首先 , 我 们 在 CrimeFragment 布 局 中 添加 两 个 投诉 用 按钮 : 一 个 嫌疑 人 选取 按钮 (CHOOSE 
SUSPECT 按 钮 ) 和 一 个 消息 发 送 按钮 ( SEND CRIME REPORT 按 钮 )。 添 加 按钮 前 ， 先 来 添加 显 


示 在 按钮 上 的 字符 串 资源 ， 如 代码 清单 15-1 所 示 。 
代码 清单 15-1 添加 按钮 用 字符 串 〈strings.xml ) 


<string name="subtitle format">%1$d crimes</string> 

<string name="crime suspect text">Choose Suspect</string> 

<string name="crime report text">Send Crime Report</string> 
</resources> 


然后 ， 在 layout/fragment_crime.xml 布 局 文件 中 ， 参 照 图 15-2， 添 加 两 个 按钮 组 件 。 注 意 , 为 
了 突出 重点 ， 我 们 在 布局 定义 示意 图 中 隐藏 了 LinearLayout 的 部 分 子 元 素 。 

















LinearLayout 
xmlns:android="http://schemas.android,.com/apk/res/android" 


android:orientation="vertical" 
android:layout_width="match_parent" 
android: layout_height="match_parent" 


eee 


Button Button 





android:id="@+id/crime_suspect" android: id="@+id/crime_report" 


android: layout_width="match_parent" android: layout_width="match_parent" 
android: layout_height="wrap_content" android: layout_height="wrap_content" 


android:text="@string/crime_suspect_text" android:text="@string/crime_report_text" 

















图 15-2 ”添加 嫌疑 人 选取 按钮 和 消息 发 送 按钮 ( layout/fragment_crime.xml ) 











现在 ， 可 以 预览 新 布局 了 。 当 然 ， 也 可 以 直接 运行 CriminalIntent 应 用 ,确认 新 增加 的 按钮 显 
示 正 常 。 


15.2 ”添加 嫌疑 人 信息 至 模型 层 


接 下 来 ， 返 回 到 Crime,java 中 ， 新 增 存 储 嫌 疑 人 姓名 的 msuspect 成 员 变 量 ， 如 代码 清单 1$-2 
所 示 。 
代码 清单 15-2 ”添加 mSuspect 成 员 变 量 ( Crime.java ) 


public class Crime { 














private boolean mSolved; 
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private String mSuspect; 


public Crime() { 
this (UUID. randomUUID()); 
} 


public void setSolved(boolean solved) { 
mSolved = solved; 


} 


public String getSuspect() { 
return mSuspect; 


} 


public void setSuspect(String suspect) { 
mSuspect = suspect; 
} 
} 


现在 ， 需 要 新 增 crime 数 据 库 字段 。 首 先 ， 在 数据 库 schema 中 定义 嫌疑 人 字段 ， 如 代码 清单 
15-3 所 示 。 
代码 清单 15-3 ”添加 嫌疑 人 数据 库 字 段 ( CrimeDbSchema.java ) 


public class CrimeDbSchema { 
public static final class CrimeTable { 
public static final String NAME = "crimes"; 














public static final class Cols { 
public static final String UUID = "uuid"; 
public static final String TITLE = "title"; 
public static final String DATE = "date"; 
public static final String SOLVED = "solved"; 
public static final String SUSPECT = "suspect"; 


} 
同时 ， 也 要 在 CrimeBaseHelper 中 新 增 嫌疑 人 数据 库 字 段 ， 如 代码 清单 15-4 所 示 。( 注意 ， 
别 忘 了 CrimeTable.Cols.S0LVED 后 的 逗号 。) 


代码 清单 15-4 ”添加 嫌疑 人 数据 库 字 段 ( CrimeBaseHelper.java ) 








@Override 
public void onCreate(SQLiteDatabase db) { 15 
db .execSQL( "create table " + CrimeTable.NAME + "(" + 
" _id integer primary key autoincrement, " + 
CrimeTable.Cols.UUID + ", "+ 
CrimeTable.Cols.TITLE + ", "+ 
CrimeTable.Cols.DATE + ", "+ 
CrimeTable.Cols.SOLVED + ", "+ 


CrimeTable.Cols.SUSPECT + 
时) 


246 第 15 章 


隐 式 intent 





接 下 来 ， 更 新 CrimeLab.getContentValues (Crime) 方 法 中 的 数据 库 写 人 代码 ， 如 代码 清 


单 15-5 所 示 。 





代码 清单 15-5 ” 写 和 人 嫌疑 人 信息 ( CrimeLab.java ) 


private st 
Conten 


values. 
values. 


values 


values. 
values. 


return 


} 





atic ContentValues getContentValues(Crime crime) { 
tValues values = new ContentValues(); 
put(CrimeTable.Cols.UUID, crime.getId().toString()); 
put(CrimeTable.Cols.TITLE, crime.getTitle()); 
.put(CrimeTable.Cols.DATE, crime.getDate().getTime()); 
put(CrimeTable.Cols.SOLVED, crime.isSolved() ? 1 : 0); 
put(CrimeTable.Cols.SUSPECT, crime.getSuspect()); 


values; 





最 后 ， 更 新 CrimeCursorWrapper 中 的 数据 库 读 取代 码 ， 如 代码 清单 15-6 所 示 。 
代码 清单 15-6 读 取 嫌疑 人 信息 ( CrimeCursorWrapper.java ) 


public Cri 
String 
String 
Long d 
int is 
String 
Crime 
crime 
crime 


crime. 
crime. 


return 


} 


注意 ， 如 果 设 备 上 已 安装 CriminalIntent 应 用 ， 当 前 应 用 中 的 数据 库 是 不 包含 嫉 








me getCrime() { 
uuidString = getString(getColumnIndex(CrimeTable.Cols.UUID)); 
title = getString(getColumnIndex(CrimeTable.Cols.TITLE)); 
ate = getLong(getColumnIndex(CrimeTable.Cols.DATE)); 
Solved = getInt(getColumnIndex(CrimeTable.Cols.SOLVED)); 
suspect = getString(getColumnIndex (CrimeTable.Cols .SUSPECT)); 


crime = new Crime(UUID.fromString(uuidString)); 


.SetTitle(title); 


setDate(new Date(date) ) ; 
setSolved(isSolved != 0); 
setSuspect(suspect); 


crime; 























k 疑 人 字段 的 ， 


而 且 onCreate(SQLiteDatabase) 方 法 也 不 会 添加 这 个 新 字段 。 这 时 , 最 容易 的 解决 办 法 就 是 删 
除 旧 数 据 库 (这 是 开发 过 程 中 常 有 的 事 )。 

如 前 所 述 , 首先 删除 CriminalIntent 应 用 。 然 后 , 从 Android Studio 中 重新 安装 并 运行 它 。 这 样 ， 
带 有 新 增 字 段 的 数据 库 就 创建 成 功 了 。 


15.3 ”使 用 格式 化 字符 串 








最 后 一 项 准备 工作 是 创建 消息 模板 。 应 月 


须 使 用 带 有 占 位 符 


<string name="crime report">%l$s! The crime was discovered on %2$s. %3$s, and %4$s 








(可 在 应 用 运行 时 替换 ) 的 格式 化 字符 串 。 下 面 是 将 要 使 用 的 格式 化 











> Ah dD 


字符 中 


运行 前 ,我们 无 法 获知 具体 的 陋习 细节 。 因 此 ， 必 


到 


1 





%1$s 、%2$s 等 特殊 字符 串 即 为 占 位 符 ， 它 们 接受 字符 串 参 数 。 在 代码 中 ,我们 将 调用 
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getString(...) 方 法 ， 并 传人 格式 化 字符 串 资源 ID 以 及 另外 四 个 字符 串 参 数 ( 与 要 替换 的 占 位 
符 顺 序 一 致 )。 
首先 ， 在 strings.xml 中 ， 添 加 如 代码 清单 15-7 所 示 的 字符 串 资 源 。 


代码 清单 15-7 ”添加 字符 串 资 源 〈strings.xml ) 


<string name="crime suspect text">Choose Suspect</string> 

<string name="crime report text">Send Crime Report</string> 

<string name="crime_report">%1$s! 

The crime was discovered on %2$s. %3$s, and %4$s 

</string> 

<string name="crime report solved">The case is solved</string> 

<string name="crime_ report _ unsolved">The case is not solved</string> 

<string name="crime report no_suspect">there is no suspect.</string> 

<string name="crime_report_suspect">the suspect is %s.</string> 

<string name="crime_ report subject">CriminalIntent Crime Report</string> 

<string name="send_report">Send crime report via</string> 
</resources> 


然后 ,在 CrimeFragment.java 中 添加 getCrimeReport() 方 法 , 创建 四 段 字 符 串 信息 ， 并 返回 
拼接 完整 的 消息 ， 如 代码 清单 15-8 所 示 。 
代码 清单 15-8 ”新 增 getCrimeReport() 方 法 (CrimeFragment.java ) 


private void updateDate() { 
mDateButton.setText (mCrime.getDate().toString()); 

















} 


private String getCrimeReport() { 
String solvedString = null; 
if (mCrime.isSolved()) { 
solvedString = getString(R.string.crime report solved); 
} else{ 
solvedString = getString(R.string.crime_report_unsolved); 


} 


String dateFormat 
String dateString 


"EEE, MMM dd"™; 
DateFormat.format (dateFormat, mCrime.getDate()).toString(); 


String suspect = mCrime.getSuspect(); 
if (suspect == nuLL) { 
suspect = getString(R.string.crime_report_no_suspect); 


0 . 5 
suspect = getString(R.string.crime_report_ suspect, suspect); 


} 





String report = getString(R.string.crime_report, 
mCrime.getTitle(), dateString, solvedString, suspect); 


return report; 
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( 注意, 有 两 个 DateFormat 类 : android.text .format.DateFormat 和 java.text .DateFormat。 
我 们 要 用 的 是 android.text.format.DateFormat。) 
至 此 ， 准 备 工 作 全 部 完成 了 ， 接 下 来 学 习 如 何 使 用 隐 式 intent。 


15.4 ”使 用 隐 式 intent 


Intent 对 象 用 来 向 操作 系统 说 明 需 要 处 理 的 任务 。 使 用 显 式 intent 时 ， 我 们 需 指 定 要 操作 系 
统 启动 哪个 activity。 下 面 是 之 前 创建 过 的 显 式 intent: 


Intent intent = new Intent(getActivity(), CrimePagerActivity.class); 
intent.putExtra(EXTRA CRIME ID，crimeId) ; 
startActivity(intent); 


使 用 隐 式 intent 时 ， 只 需 告 诉 操 作 系 统 你 想 要 做 什么 ,操作 系统 就 会 去 启动 能 够 胜任 工作 任 
务 的 activity。 如 果 找 到 多 个 符合 的 activity， 用户 会 看 到 一 个 可 选 应 用 列表 ,然后 就 看 用 户 如 何 选 
择 了 。 


15.4.1 隐 式 intent 的 组 成 


下 面 是 隐 式 intent 的 主要 组 成 部 分 ， 可 以 用 来 定义 你 想 做 的 事 。 

(1) 要 执行 的 操作 

通常 以 Intent 类 中 的 常量 来 表示 。 例如 , 要 访问 某 个 URL, 可 以 使 用 Intent.ACTION_VIEW; 
要 发 送 邮 件 ， 可 以 使 用 Intent .ACTION_SEND。 

(2) 待 访 问 数据 的 位 置 

这 可 能 是 设备 以 外 的 资源 ， 如 某 个 网 页 的 URL， 也 可 能 是 指向 某 个 文件 的 URI， 或 者 是 指向 
ContentProvider 中 某 条 记录 的 某 个 内 容 URI (content URI )。 

(3) 操作 涉及 的 数据 类 型 

这 指 的 是 MIME 形 式 的 数据 类 型 ， 如 text/html 或 audio/mpeg3。 如 果 一 个 intent 包 含 数据 位 置 ， 
那么 通常 可 以 从 中 推测 出 数据 的 类 型 。 

(4) 可 选 类 别 

操作 用 于 描述 具体 要 做 什么 ， 而 类 别 通常 用 来 描述 你 打算 何 时 、 何 地 或 者 如 何 使 用 某 个 
activity。 例 如 ，Android 的 android.intent.category.LAUNCHER 类 别 表 明 ，activity 应 该 显示 在 
顶级 应 用 启动 器 中 ; 而 android.intent.category.INF0 类 别 表 明 ， 虽 然 activity 向 用 户 显 示 了 
包 信 息 ， 但 它 不 应 该 出 现在 启动 器 中 。 

一 个 查看 某 个 网 址 的 简单 隐 式 intent 会 包括 一 个 Intent .ACTION_VIEW 操 作 ， 以 及 某 个 具体 
URL 网 址 的 Uri 数 据 。 

基于 以 上 信息 ， 操 作 系 统 将 启动 适用 的 activity。( 如 果 有 多 个 应 用 适用 ， 用 户 自己 挑 。) 

通过 配置 文件 中 的 intent 过 滤器 设置 ，activity 会 对 外 宣称 自己 是 适合 处 理 ACTION_VIEW 的 
activity。 例 如 ， 如 果 想 开发 一 款 浏 览 器 应 用 ， 为 了 响应 ACTION_VIEW 操 作 ， 你 会 在 activity 声 明 中 
包含 以 下 intent 过 滤器 : 
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<activity 
android:name=" .BrowserActivity" 
android:label="@string/app_name" > 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<data android:scheme="http" android:host="www.bignerdranch.com" /> 
</intent-filter> 
</activity> 


必须 在 intent 过 滤器 中 明确 地 设置 DEFAULT 类 别 。action 元 素 告 诉 操作 系统 ，activity 能 够 胜 
任 指定 任务 。DEFAULT 类 别 告诉 操作 系统 ( 问 谁 可 以 做 时 )，activity 愿 意 处 理 某 项 任务 。DEFAULT 
类 别 实际 隐 伟 于 所 有 隐 式 intent 中 。( 当然 也 有 例外 ， 详 见 第 24 章 。) 

和 显 式 intent 一 样 ， 隐 式 intent 也 可 以 包含 extra 信 息 。 不 过 , 操作 系统 在 寻找 适用 的 activity 时 ， 
不 会 使 用 附加 在 隐 式 intent 上 的 任何 extra。 

注意 ， 显 式 intent 也 可 以 使 用 隐 式 intent 的 操作 和 数据 部 分 。 这 相当 于 要 求 特定 的 activity 去 做 
特定 的 事 。 





15.4.2 ”发 送 消息 


在 CriminalIntent 应 用 中 , 通过 创建 发 送 消 息 的 隐 式 intent, 我 们 来 看 看 它 是 如 何 工 作 的 。 消息 
是 由 字符 串 组 成 的 文本 信息 ,我 们 的 任务 是 发 送 一 段 文 本 信息 ， 因 此 隐 式 intent 的 操作 是 
ACTION_SEND。 它 不 指向 任何 数据 ， 也 不 包含 任何 类 别 ， 但 会 指定 数据 类 型 为 text/plain。 

在 CrimeFragment .onCreateView(...) 方 法 中 ,首先 以 资源 ID 引 用 SEND CRIME REPORT 
按钮 并 为 其 设置 一 个 监听 器 。 然 后 在 监听 器 接口 实现 中 ， 创 建 一 个 隐 式 intent 并 传人 
startActivity(Intent) 方 法 ， 如 代码 清单 15-9 所 示 。 



































代码 清单 15-9 ”发 送 消息 ( CrimeFragment.java ) 


private Crime mCrime; 

private EditText mTitleField; 
private Button mDateButton; 
private CheckBox mSolvedCheckbox; 
private Button mReportButton; 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


mReportButton = (Button) v.findViewById(R.id.crime_ report); 
mReportButton.setOnClickListener (new View.OnClickListener() { 
public void onClick(View v) { 
Intent i = new Intent(Intent.ACTION SEND); 
i.setType("text/plain"); 
i.putExtra(Intent.EXTRA TEXT, getCrimeReport()); 
i.putExtra(Intent .EXTRA SUBJECT, 
getString(R.string.crime_report_ subject)); 
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startActivity(i); 
} 
}); 


return v; 

} 

以 上 代码 使 用 了 一 个 接受 字符 串 参数 的 Intent 构 造 方法 ， 我 们 传人 的 是 一 个 定义 操作 的 常 
量 。 取 决 于 要 创建 的 隐 式 intent 类 别 ， 还 有 一 些 其 他 形式 的 构造 方法 可 用 。 可 以 查阅 Intent 参 考 
文档 进一步 了 解 。 因 为 没有 接受 数据 类 型 的 构造 方法 可 用 ， 所 以 必须 专门 设置 它 。 

消息 内 容 和 主题 是 作为 extra 附 加 到 intent 上 的 。 注 意 ， 这 些 extra 信 息 使 用 了 Intent 类 中 定 
义 的 常量 。 因 此 ， 任 何 响应 该 intent 的 activity 都 知道 这 些 常量 ， 自 然 也 知道 该 如 何 使 用 它们 的 
关联 值 。 

运行 CriminalIntent 应 用 并 点 SEND CRIME REPORT 按 钮 。 因 为 刚 创建 的 intent 会 匹配 设备 上 
的 许多 activity， 所 以 你 很 可 能 会 看 到 长 长 的 候选 activity 列 表 ， 如 图 15-3 所 示 。 
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图 15-3 ”支持 发 送 消息 的 全 部 activity 
从 列表 中 作出 选择 后 ， 可 以 看 到 消息 加 载 到 了 所 选 应 用 中 。 接 下 来 ， 只 需 填 和 人 地址， 点 击发 
送 即 可 。 
然而 ， 有 时 可 能 看 不 到 候选 activity 列 表 。 出 现 这 种 情况 通常 有 两 个 原因 : 要 么 是 针对 某 个 隐 
式 intent 设 置 了 默认 响应 应 用 ， 要 么 是 设备 上 仅 有 一 个 activity 可 以 响应 隐 式 intent。 
通常 ， 对 于 某 项 操作 ， 最 好 使 用 用 户 的 默认 应 用 。 不 过 ， 在 CriminalIntent 应 用 中 ， 针 对 
ACTION_SEND 操 作 ， 应 该 总 是 将 选择 权 交 给 用 户 。 要 知道 ， 也许 今天 用 户 想 低调 处 理 问题 ， 只 采 
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取 邮 件 的 形式 发 送 陋习 报告 ， 而 明天 很 可 能 就 改变 主意 了 : 更 希望 通过 Twitter 公开 择 击 那些 公共 
场所 的 陋习 。 

使 用 隐 式 intent 启 动 activity 时 ， 也 可 以 创建 每 次 都 显示 的 activity 选 择 吉 。 和 以 前 一 样 创 建 隐 
式 intent 后 ， 调 用 以 下 Intent 方 法 并 传人 创建 的 隐 式 intent 以 及 用 作 选 择 器 标题 的 字符 串 : 


public static Intent createChooser(Intent target, String title) 


然后 ， 将 createChooser(...) 方 法 返回 的 intent 传 人 startActivity(...) 方 法 。 
在 CrimeFragment.java 中 ， 创建 一 个 选择 器 显示 响应 隐 式 intent 的 全 部 activity， 如 代码 清单 
15-10 所 示 。 


代码 清单 15-10 ”使 用 选择 器 ( CrimeFragment.java ) 


public View onCreateView(layoutinflater inflater, ViewGroup container, 
Bundle savedinstanceState) { 














mReportButton.setOnClicklistener(new View.0nCLickListener() { 

public void onClick(View v) { 
Intent i = new Intent(Intent.ACTION SEND); 
i.setType("text/plain"); 
i.putExtra(Intent.EXTRA TEXT, getCrimeReport()); 
i.putExtra(Intent.EXTRA SUBJECT, 

getString(R.string.crime report subject)); 
= Intent.createChooser(i, getString(R.string.send_report)); 
startActivity(i); 
} 


运行 CriminalIntent 应 用 并 点 击 SEND CRIME REPORT 按 钮 。 可 以 看 到 ， 只 要 有 多 个 activity 
可 以 处 理 隐 式 intent， 就 会 得 到 一 个 候选 activity 列 表 ， 如 图 15-4 所 示 。 
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图 15-4 ”通过 选择 器 选择 应 用 发 送 消 息 
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15.4.3 ”获取 联系 人 信息 


现在 ,创建 男 一 个 隐 式 intent， 让 用 户 从 联系 人 应 用 里 选择 嫌疑 人 。 这 个 隐 式 intent 将 由 操作 
以 及 数据 获取 位 置 组 成 ,操作 为 Intent .ACTION PICK。 联系 人 数据 获取 位 置 为 ContactsContract. 
Contacts ,CONTENT_URI。 简 而 言 之 ,就 是 请 Android 帮 忙 从 联系 人 数据 库 里 获取 某 个 具体 的 联系 人 。 

因为 要 获取 启动 activity 的 返回 结果 ， 所 以 我 们 调用 startActivityForResult(...,) 方 法 
并 传人 intent 和 请 求 代 码 。 在 CrimeFragment.java 中 ， 新 增 请 求 代码 常量 和 按钮 成 员 变 量 ， 如 代码 
清单 15-11 所 示 。 


代码 清单 15-11 添加 嫌疑 人 按钮 成 员 变 量 ( CrimeFragment.java ) 


private static final int REQUEST DATE = 0; 
private static final int REQUEST CONTACT = 1; 















































private Button mSuspectButton; 
private Button mReportButton; 


在 onCreateView(...) 方 法 的 末尾 ， 引 用 新 增 按钮 并 为 其 设置 监听 器 。 在 监听 器 接口 实现 
中 ,创建 一 个 隐 式 intent 并 传人 startActivityForResult(,.,.,) 方 法 。 最 后 ， 如 果 找 到 联系 人 ， 
就 将 其 名 字 显 示 在 按钮 上 ， 如 代码 清单 15-12 所 示 。 


代码 清单 15-12 ”发 送 隐 式 intent ( CrimeFragment.java ) 


public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 














final Intent pickContact = new Intent(Intent.ACTION PICK, 
ContactsContract.Contacts .CONTENT_URI); 
mSuspectButton = (Button) v.findViewById(R.id.crime suspect); 
mSuspectButton.setOnClickListener(new View.0nCLickListener() { 
public void onClick(View v) { 
startActivityForResult(pickContact, REQUEST_ CONTACT); 
} 
}); 


if (mCrime.getSuspect() != nuLL) { 
mSuspectButton.setText (mCrime.getSuspect()); 
} 


return v; 
} 
稍 后 还 会 使 用 pickContact ， 所 以 这 里 没有 将 它 放 在 0nCLickListener 监 听 需 代码 中 。 
运行 CriminalIntent 应 用 并 点 击 CHOOSE SUSPECT 按 钮 ， 应 该 能 看 到 一 个 类 似 图 15-5 所 示 的 
联系 人 列表 。 
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图 15-5 包含 嫌疑 人 的 联系 人 列表 


注意 ,如 果 设 备 上 安装 了 其 他 联系 人 应 用 ,应 用 界面 可 能 会 有 所 不 同 。 另 外 可 以 看 到 ， 从 当 
前 应 用 中 调用 联系 人 应 用 时 ， 完 全 不 用 知道 应 用 的 名 字 。 因 此 , 用 户 可 以 安装 任何 喜爱 的 联系 人 
应 用 ， 操 作 系统 会 负责 找到 并 启动 它 。 

1. 从 联系 人 列表 中 获取 联系 人 数据 

现在 ， 需 要 从 联系 人 应 用 中 获取 返回 结果 。 很 多 应 用 都 会 共享 联系 人 信息 ， 因 此 Android 提 
供 了 一 个 深度 定制 的 API 用 于 处 理 联 系 人 信息 : ContentProvider 类 。 该 类 的 实例 封装 了 联系 人 
数据 库 并 提供 给 其 他 应 用 使 用 。 我 们 可 以 通过 contentResolver 访 问 ContentProvider。 

前 面 ， 我 们 以 ACTION_PICK 启 动 了 activity 并 要 求 返 回 结果 ， 因 此 调用 onActivityResult 
(,.. ) 方 法 会 接收 到 一 个 intent。 该 intent 包 括 了 数据 URI。 这 个 URI 是 个 数据 定位 符 ， 指 问 用 户 所 
选 的 联系 人 。 

在 CrimeFragment.java 中 , 将 代码 清单 15-13 所 示 的 代码 添加 到 onActivityResult(...) 实 现 
方法 中 。 


代码 清单 15-13 ”获取 联系 人 姓名 ( CrimeFragment.java ) 


@Override 
public void onActivityResult(int requestCode, int resultCode, Intent data) { 15 


if (resultCode != Activity.RESULT OK) { 
return; 









































} 
if (requestCode == REQUEST DATE) { 
updateDate( ); 


} else if (requestCode == REQUEST CONTACT && data != nuLL) { 
Uri contactUri = data.getData(); 
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// Specify which fields you want your query to return 

// values for. 

String[] queryFields = new String[] { 
ContactsContract.Contacts .DISPLAY_NAME 

}; 

// Perform your query - the contactUri is like a "where" 

// clause here 

Cursor c = getActivity().getContentResolver() 
.query(contactUri, queryFields, null, null, null); 


try { 
// Double-check that you actually got results 
if (c.getCount() == 0) { 
return; 


} 


// Pull out the first column of the first row of data - 
// that is your suspect's name 
c.moveToFirst(); 
String suspect = c.getString(0); 
mCrime.setSuspect (suspect); 
mSuspectButton.setText (suspect); 
} finally { 
c.close(); 


} 


} 

以 上 代码 创建 了 一 条 查询 语句 ， 要求 返回 全 部 联系 人 的 名 字 。 然 后 查询 联系 人 数据 库 ， 获 得 
一 个 可 用 的 Cursor。 因 为 已 经 知道 Cursor 只 包含 一 条 记录 ， 所 以 将 Cursor 移 动 到 第 一 条 记录 并 
获取 它 的 字符 串 形式 。 该 字符 串 即 为 嫌疑 人 的 姓名 。 然 后 ， 使 用 它 设置 Crime 嫌 疑 人 ， 并 显示 在 
CHOOSE SUSPECT 按 钮 上 。 

(联系 人 数据 库 是 一 个 比较 复杂 的 主题 , 这 里 不 会 展开 讨论 。 如 需 详 细 了 解 , 可 以 阅读 Contacts 
Provider API 指 南 : developer.android.com/guide/topics/providers/contacts-provider.html。 ) 

现在 可 以 运行 应 用 测试 了 。 有些 设备 可 能 没有 联系 人 应 用 可 用 , 如 果 是 这 样 , 请 使 用 模拟 器 。 

2. 联系 人 信息 使 用 权限 

如 何 获得 读 取 联 系 人 数据 库 的 权限 呢 ? 实际 上 ， 这 是 联系 人 应 用 将 其 权限 临时 赋予 了 我 们 。 
联系 人 应 用 有 使 用 联系 人 数据 库 的 全 部 权限 。 联 系 人 应 用 返回 包含 在 intent 中 的 URI 数 据 给 父 
activity 时 ,会 添加 一 个 Intent.FLAG GRANT READ URI PERMISSION 标 志 。 该 标志 告诉 Android， 
CriminalIntent 应 用 中 的 父 activity 可 以 使 用 联系 人 数据 一 次 。 这 很 有 用 ， 因 为 不 需要 访问 整个 联系 
人 数据 库 ， 我 们 只 需要 访问 其 中 的 一 条 联系 人 信息 。 






























































15.4.4 检查 可 响应 任务 的 activity 


本 章 创建 的 第 一 个 隐 式 intent 总 是 会 以 某 种 方式 得 到 响应 ， 因 为 就 算 没 有 可 用 的 消息 发 送 应 
用 ,至少 还 会 出 现 一 个 应 用 选择 器 ; 但 第 二 个 就 不 一 定 了 , 因为 有 些 设备 上 根本 就 没有 联系 人 应 
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用 。 如 果 操 作 系 统 找 不 到 匹配 的 activity， 应 用 就 会 月 演 。 
oat nd 并 行 自 检 , 在 onCreateView(...) 方 
法 中 实现 检查 ， 如 代码 清单 15-14 所 示 。 


代码 清单 15-14 ”检查 是 否 存在 联系 人 应 用 ( CrimeFragment.java ) 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 

















if (mCrime.getSuspect() != null) { 
mSuspectButton.setText(mCrime.getSuspect()); 
} 


PackageManager packageManager = getActivity().getPackageManager(); 
if (packageManager.resolveActivity(pickContact, 
PackageManager .MATCH_DEFAULT_ONLY) == null) { 
mSuspectButton. setEnabled (false); 
} 


return v; 


} 


Android 设 备 上 安装 了 哪些 组 件 以 及 包括 哪些 activity，PackageManager 类 全 都 知道 。( 本 书 
后 续 章 节 还 会 介绍 更 多 组 件 。) 调用 resolveActivity(Intent，int) 方 法 ， 可 以 找到 匹配 给 定 
Intent 任 务 的 activity。flag 标 志 MATCH_DEFAULT_0NLY 限 定 只 搜索 带 CATEGORY_DEFAULT 标 志 的 
activity。 这 和 startActivity(Intent) 方 法 类 似 。 

如 果 搜 到 目标 ， 它 会 返回 ResoLveInfo 告 诉 我 们 找到 了 哪个 activity。 如 果 找 不 到 的 话 ， 必 须 
禁用 嫌疑 人 按钮 ， 否 则 应 用 就 会 月 淡 。 

如 果 想 验证 过 滤器 ,但 手头 又 没有 不 带 联 系 人 应 用 的 设备 ， 可 临时 添加 额外 的 类 别 给 intent。 
这 个 类 别 没 有 实际 的 作用 ， 只 是 阻止 任何 联系 人 应 用 和 你 的 intent 匹 配 。 过 滤器 验证 代码 如 代码 
清单 15-15 所 示 。 


代码 清单 15-15 ”过 滤器 验证 代码 ( CrimeFragment.java ) 


public View onCreateView(layoutinflater inflater, ViewGroup container, 
Bundle savedinstanceState) { 







































































final Intent pickContact = new Intent(Intent.ACTION PICK, 
ContactsContract.Contacts .CONTENT_ URI); 

pickContact.addCategory(Intent .CATEGORY_HOME); 

mSuspectButton = (Button)v.findViewById(R.id.crime suspect); 

mSuspectButton.setOnClickListener(new View.OnClickListener() { 














现在 ， 嫌 疑 人 按钮 应 该 被 禁用 了 ， 如 图 15-6 所 示 。 
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BL EA 
€ Criminalintent 
TITLE 


stolen yogurt 





DETAILS 


MON DEC 12 11:07:50 EST 2016 





Solved 











SEND CRIME REPORT 


图 15-6 嫌疑 人 选取 按钮 已 禁用 
验证 完毕 ， 记 得 删除 相关 代码 ， 如 代码 清单 15-16 所 示 。 
代码 清单 15-16 ”删除 验证 代码 ( CrimeFragment.java ) 


public View onCreateView(layoutinflater inflater, ViewGroup container, 
Bundle savedinstanceState) { 
































final Intent pickContact = new Intent(Intent.ACTION PICK, 
ContactsContract.Contacts .CONTENT_URI); 


mSuspectButton = (Button)v. findViewById(R.id.crime suspect); 
mSuspectButton.setOnClickListener(new View.OnClickListener() { 


}); 


15.5 ”挑战 练习 : ShareCompat 


个 练习 比较 简单 。Android 支 持 库 有 个 叫 作 ShareCompat 的 类 ， 它 有 一 个 内 部 类 叫 
人 使 用 这 个 内 部 类 创建 发 送 消 息 的 Intent 略 微 方便 一 些 。 
因此 ， 请 在 mReportButton 的 监听 器 中 ， 改 用 ShareCompat.IntentBuilder 来 创建 你 的 
Intent。 


15.6 ”挑战 练习 : 又 一 个 隐 式 intent 


相 较 于 发 送 消息 , 愤怒 的 用 户 可 能 更 倾向 于 直接 责问 陋习 嫌疑 人 。 新 增 一 个 按钮 允许 用 户 
直接 拨打 陋习 嫌疑 人 的 电话 。 















































15.6 ”挑战 练习 : 又 一 个 隐 式 intent 257 








要 完成 这 个 挑战 ， 首 先 需要 联系 人 数据 库 中 的 手机 号 码 。 这 需要 查询 ContactsContract 数 
据 库 中 的 CommonDataKinds.Phone 表 。 如 何 查 询 ， 请 查看 它们 的 参考 文档 。 

小 提示 : 你 应 该 使 用 android.permission.READ CONTACTS 权 限 。 利 用 这 个 权限 ， 可 以 查询 
到 ContactsContract ,Contacts,， ID。 然 后 再 使 用 联系 人 ID 查询 CommonDatakinds .Phone 表 。 

搞定 了 电话 号 码 ， 就 可 以 使 用 电话 URI 创 建 一 个 隐 式 intent: 

Uri number = Uri.parse("tel:5551234"); 

与 打 电 话 相关 的 Intent 操 作 有 两 种 : Intent.ACTION DIAL 和 Intent.ACTION CALL。 
ACTION_CALL 直 接 调 出 手机 应 用 并 拨打 来 自 intent 的 电话 号 码 ; 而 ACTION_DIAL 则 拨 好 电话 号 码 ， 
然后 等 用 户 发 起 通话 。 

推荐 使 用 ACTION_DIAL 操 作 。 这 样 的 话 ， 用 户 就 有 了 冷静 下 来 改变 主意 的 机 会 。 这 种 贴心 的 
设计 应 该 会 受到 欢迎 的 。 
































使 用 intent 拍 照 











掌握 了 隐 式 intent 之 后 ， 可 考虑 进一步 丰富 crime 记 录 细 节 了 。 例 如， 给 陋习 现场 拍 张 照片 就 























是 个 不 错 的 主意 。 
拍照 需要 用 到 一 些 包括 隐 式 intent 在 内 的 新 工具 。 隐 式 intent 可 以 启动 用 户 喜 爱 的 相机 应 用 并 
接收 它 拍摄 的 照片 。 








接收 到 照片 后 ， 该 如 何 存储 和 展示 这 些 照 片 呢 ? 答案 就 在 本 章 。 


16.1 布置 照片 


首先 要 做 的 是 在 用 户 界面 上 布置 照片 。 这 需要 新 增 两 个 View 对 象 : 显示 照片 缩 略 图 的 
ImageView 和 拍照 按钮 。 完 成 后 的 用 户 界 面 如 图 16-1 所 示 。 


BLEAY 
€ Criminalintent 


TITLE 











Yogurt thievery 





[| 
DETAILS 


MON DEC 12 12:44:53 EST 2016 





Solved 











CHOOSE SUSPECT 


SEND CRIME REPORT 


图 16-1 重新 布置 的 用 户 界面 


在 同一 行 放置 照片 缩 略 图 和 拍照 按钮 的 话 ， 应 用 界面 就 会 显得 拥挤 ， 给 人 不 专业 的 感觉 。 下 
面 就 来 合理 地 布置 这 两 个 视图 。 
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dS 


参照 图 16-2 所 示 的 布局 示意 图 ， 把 新 视图 放 入 fragment_crime.xml 布 局 。 从 左手 边 开 始 ， 首先 
添加 ImageView 视 图 用 来 显示 上 照片， 再 添加 ImageButton 视 图 用 来 拍照 。 


LinearLayout 


LinearLayout 
android:orientation="horizontal" 


android: layout_width="match_parent" [esvew] 

androldi layout heloht="wrap content| 。 [Textiew| [euton] [enecksox] [Eutton| [Button| 
android: layout_marginLeft="16dp" 

android: layout_marginTop="16dp" 








LinearLayout 
android:orientation="vertical" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 


ImageView 
android:id="@+id/crime_photo" ImageButton 
android; layout_width="80dp" android;id="@+id/crime_camera" 
android: layout_height="88dp" android: layout_width="match_parent" 
android:scaleType=" centerInside" android: layout_height="wrap_content" 
android:cropToPadding="true" android:src="@android:drawable/ic_menu_camera" 


android:background="@android:color/darker_gray" 





图 16-2 ”相机 视图 布局 (res/layout/fragment crime.xml ) 


然后 ， 参 照 图 16-3 所 示 的 示意 图 ， 从 右手 边 开 始 ， 把 TextView 标 题 栏 和 EditText 文 字 框 放 
入 一 个 新 LinearLayout 布 局 中 ， 再 安排 其 作为 图 16-2 新 建 的 LinearLayout 布 局 的 子 布局 。 


dS 








LinearLayout 
android:orientation="vertical" 
android: layout_width="Qdp" 





android: layout_height="wrap_content" 
android: layout_weight="1" 
TextView EditText 
android: layout_width="match_parent" android:id="@+id/crime_title" 


android: layout_height="wrap_content" android: layout_width="match_parent" 


android:text="@string/crime_title_label" android: layout_height="wrap_content" 
style="?android:listSeparatorTextViewStyle" android:hint="@string/crime_title_hint" 














图 16-3 ”标题 栏 布局 ( res/layout/fragment_ crime.xml ) 
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运行 CriminalIntent 应 用 ， 应 该 可 以 看 到 如 图 16-1 所 示 的 应 用 界面 。 

漂亮 的 用 户 界面 完成 了 ， 但 要 响应 ImageButton 按 钮 点 击 和 控制 InageView 视 图 的 内 容 展 
示 ， 我 们 还 要 添加 引用 它们 的 实例 变量 。 和 以 前 一 样 ， 调 用 findViewById(int) 方 法 从 
fragment_crime.xml 布 局 中 找到 相应 视图 并 使 用 它们 ， 如 代码 清单 16-1 所 示 。 


























代码 清单 16-1 添加 实例 变量 ( CrimeFragment.java ) 


private Button mSuspctButton; 

private Button mReportButton; 

private ImageButton mPhotoButton; 

private ImageView mPhotoView; 

@Override 

public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


PackageManager packageManager = getActivity().getPackageManager(); 
if (packageManager.resolveActivity(pickContact, 
PackageManager .MATCH DEFAULT ONLY) == nuLL) { 
mSuspectButton.setEnabled(false); 
} 


mPhotoButton = (ImageButton) v.findViewById(R.id.crime camera); 
mPhotoView = (ImageView) v.findViewById(R.id.crime photo); 


return v; 


} 
与 用 户 界面 相关 的 工作 完成 了 。 接 下 来 的 任务 是 编码 实现 拍照 和 显示 照片 功能 。 


16.2 ”文件 存储 


相机 所 拍摄 的 照片 动 轩 几 MB 大 小 ， 保 存在 SQLite 数 据 库 中 肯定 不 现实 。 显 然 ， 它们 需要 在 
设备 文件 系统 的 某 个 地 方 保存 。 

很 好 , 设备 上 就 有 这 么 一 个 地 方 : 私有 存储 空间 。 还 记得 吗 ? 前 面 ,我 们 在 私有 存储 空间 保 
存 过 SQLite 数据 文 件 。 使 用 类 似 Context.getFileStreamPath(String) 和 Context ， 
getFitesDir() 这 样 的 方法 ， 像 照片 这 样 的 文件 也 可 以 这 么 保存 。( 结果 就 是 照片 文件 保存 在 
databases 子 目录 相 邻 的 某 个子 目 录 中 。) 

Context 类 提供 的 基本 文件 和 目录 处 理 方法 如 下 。 
D File getFilesDir() 
获取 /data/data/< 包 名 >/files 目 录 。 
D FileInputStream openFileInput (String name) 
打开 现 有 文件 进行 读 取 。 
D FileOutputStream openFileOutput(String name, int mode) 

打开 文件 进行 写 人 ， 如 果 不 存 在 就 创建 它 。 
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D File getDir(String name, int mode) 
获取 /data/data/< 包 名 >/ 目 录 的 子 目录 (如 果 不 存 在 就 先 创建 它 )。 
口 String[] fiLeList() 
获取 主 文件 目录 下 的 文件 列表 。 可 与 其 他 方法 配合 使 用 ， 如 openFileInput (String)。 
D File getCacheDir() 
获取 /data/data/< 包 名 >/cache 目 录 。 应 注意 及 时 清理 该 目录 ， 并 节约 使 用 。 

如 果 存 储 的 文件 仅 供 应 用 内 部 使 用 ， 使 用 上 述 各 类 方法 就 够 了 。 

如 果 其 他 应 用 要 读 写 你 的 文件 ,事情 就 没 那么 简单 了 。CriminalIntent 应 用 就 是 这 个 情况 : 外 
部 相机 应 用 需要 在 你 的 应 用 里 保存 拍摄 的 照片 。 虽 然 有 个 Context .MODE_WORLD_READABLE 可 以 
传人 openFile0utput(String，int) 方 法 ,但 这 个 flag 已 经 废弃 了 。 即 使 强制 使 用 ， 在 新 系统 
设备 上 也 不 是 那么 可 靠 。 以 前 ,还 有 个 办 法 是 通过 公共 外 部 存储 转 存 , 但 出 于 安全 考虑 ， 这 条 路 
在 新 版 本 系统 上 也 被 堵 住 了 。 

如 果 想 共享 文件 给 其 他 应 用 ,或 是 接收 其 他 应 用 的 文件 ( 如 相机 应 用 拍摄 的 照片 )， 可 以 通 
过 ContentProvider 把 要 共享 的 文件 暴露 出 来 。 ContentProvider 人 允许 你 暴露 内 容 URI 给 其 他 应 
用 。 这 样 ， 这 些 应 用 就 可 以 从 内 容 URI 下 载 或 向 其 中 写 和 文件。 当然， 主动 权 在 你 手 上 ， 你 可 以 
控制 读 或 写 。 



































































































































16.2.1 使 用 FiLeProvider 


如 果 只 想 从 其 他 应 用 接收 一 个 文件 ， 自 己 实 现 ContentProvider 人 简直 是 费力 不 讨好 的 事 。 
Google 早 已 想到 这 点 ， 所 以 提供 了 一 个 名 叫 FileProvider 的 便利 类 。 这 个 类 能 帮 你 搞定 一 切 ， 
而 你 只 要 做 做 参数 配置 就 行 了 。 

首先 ,声明 FiteProvider 为 ContentProvider, 并 给 予 一 个 指定 的 权限 。 在 AndroidManifest. 
xml 中 添加 一 个 FileProvider 声 明 ， 如 代码 清单 16-2 所 示 。 


代码 清单 16-2 添加 FileProvider 声 明 ( AndroidManifest.xml ) 


<activity 
android:name=".CrimePagerActivity" 
android:parentActivityName=".CrimelistActivity"> 

</activity> 

<provider 
android:name="android. support.v4.content.FileProvider" 
android:authorities="com.bignerdranch.android.criminalintent.fileprovider" 
android:exported="false" 
android:grantUriPermissions="true"> 

</provider> 


这 里 的 权限 是 指 一 个 位 置 : 文件 保存 地 。 把 FileProvider 和 你 指定 的 位 置 关联 起 来 ， 就 相 
当 于 你 给 发 出 请 求 的 其 他 应 用 一 个 目标 地 。 添 加 exported = "fatLse" 属 性 就 意味 着 ， 除 了 你 自 
己 以 及 你 给 予 授权 的 人 , 其 他 任何 人 都 不 允许 使 用 你 的 FiLeProvider。 而 grantUriPermissions 
遇 性 用 来 给 其 他 应 用 授权 , 允许 它们 向 你 指定 位 置 的 URI 稍 后 你 会 看 到 , 这 个 位 置信 息 放 在 intent 
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中 对 外 发 出 ) 写 入 文件 。 

人 r 在 哪 ,还 需要 配置 FileProvider, 让 它 知道 该 暴露 哪 
些 文件 。 这 个 配置 用 另外 一 个 XML 资源 文件 处 理 。 在 项 目 工 具 窗 口 ， 右 键 点 击 appmes 目 录 ， 然 
后 选择 New 一 Android resource file 菜 单项 。 资 源 类 型 选 XML ， 文 件 名 输入 fles， 确 认 并 创建 这 
个 文件 。 

打开 刚刚 创建 的 xmlfiles.xml 文 件 ， 切 换 到 代码 模式 ， 按 代码 清单 16-3 替 换 原 有 内 容 。 


代码 清单 16-3 ”填写 路 径 描 述 (res/xml/files.xml ) 

















</PreferenceScreen> 
<paths> 

<files-path name="crime_photos" path="."/> 
</paths> 




















这 是 个 描述 性 XML 文 件 , 其 表达 的 意思 是 , 把 私有 存储 空间 的 根 路 径 映 射 为 crime_photos。 
2 FiteProvider 内 部 使 用 ， 你 不 应 去 用 它 。 
， 在 AndroidManifest.xml 文 件 中 ， 添 加 一 个 meta-data 标 签 ， 让 FileProvider 能 找到 
ee 如 代码 清单 16-4 所 示 。 


代码 清单 16-4 ”关联 使 用 路 径 描述 资源 ( AndroidManifest.xml ) 


<provider 
android:name="android. support.v4.content.FileProvider" 
android:authorities="com.bignerdranch.android.criminalintent.fileprovider" 
android:exported="false" 
android:grantUriPermissions="true"> 
<meta-data 
android:name="android.support.FILE PROVIDER_PATHS" 
android:resource="@xml/files"/> 
</provider> 











16.2.2 定 照片 存放 位 置 

现在 要 处 理 的 是 指定 照片 存放 人 位置。 首先 ， 在 Crime.java 中 添加 获取 文件 名 的 方法 ， 如 代码 
清单 16-5 所 示 。 
代码 清单 16-5 ”添加 文件 名 获取 方法 ( Crime.java ) 


public void setSuspect(String suspect) { 
mSuspect = suspect; 























} 


public String getPhotoFilename() { 
return "IMG " + getId().toString() + ".jpg"; 
} 
} 


Crime.getPhotoFilename() 方 法 不 知道 照片 文件 该 存储 在 哪个 目录 。 不 过 ， 既 然 文 件 名 基 
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于 Crime ID 编 制 ， 它 具有 唯一 性 。 

接 下 来 ， 找 到 要 保存 文件 的 目录 。CrimeLab 人 负责 CriminalIntent 应 用 的 数据 持久 化 工作 。 既 
然 如 此 ， 那 么 在 CrimeLab 类 里 添加 getPhotoFile(Crime) 方 法 也 就 再 合适 不 过 了 ， 如 代码 清单 
16-6 所 示 。 


代码 清单 16-6 ”定位 照片 文件 ( CrimeLab.java ) 


public class Crimelab { 




















public Crime getCrime(UUiD id) { 
} 


public File getPhotoFile(Crime crime) { 
File filesDir = mContext.getFilesDir(); 
return new File(filesDir, crime.getPhotoFilename()); 


} 


public void updateCrime(Crime crime) { 


} 
上 述 新 增 方法 不 会 创建 任何 文件 。 它 的 作用 就 是 返回 指向 某 个 具体 位 置 的 File 对 象 。 稍 后 ， 
我 们 会 使 用 FiLeProvider 把 路 径 以 URI 的 形式 对 外 暴露 。 


16.3 ”使 用 相机 intent 


现在 可 以 实现 拍照 功能 了 。 这 并 不 难 ， 只 要 使 用 一 个 隐 式 intent 就 可 以 了 。 
首先 是 保存 照片 文件 存储 位 置 ， 如 代码 清单 16-7 所 示 。( 接 下 来 好 几 个 地 方 会 用 到 它 ， 做 好 
这 步 会 省 不 少 事 。) 


代码 清单 16-7 获取 照片 文件 位 置 ( CrimeFragment.java ) 


private Crime mCrime; 
private File mpPhotoFile; 
private EditText mTitleField; 
































@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
UUID crimeId = (UUID) getArguments().getSerializable(ARG CRIME ID); 
mCrime = CrimeLab.get(getActivity()).getCrime(crimeId) ; 


mPhotoFile = CrimeLab.get(getActivity()).getPhotoFile(mCrime); 16 
} 


然后 是 处 理 相 机 拍照 按钮 ， 触 发 拍照 。 相 机 intent 定 义 在 Mediastore 里 。 这 个 类 负责 处 理 所 
有 与 多 媒体 相关 的 任务 ,发 送 一 个 带 MediaStore.ACTION IMAGE CAPTURE 操 作 的 intent, Android 
会 启动 相机 activity 拍 照 。 

实现 拍照 功能 的 思路 已 经 理 清 了 ， 但 还 有 些小 细节 要 处 理 。 
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触发 拍照 





准备 工作 都 已 完成 , 可 以 使 用 相机 intent 了 。 我们 需要 的 intent 操 作 是 定义 在 MediaStore 类 中 
的 ACTION IMAGE_ CAPTURE。MediaStore 类 定义 了 一 些 公共 接口 ， 可 用 于 处 理 图 像 、 视 频 以 及 








音乐 这 些 常 见 的 多 媒体 任务 。 当 然 ， 这 也 包括 触发 相机 应 用 的 拍照 intent。 
ACTION IMAGE CAPTURE 打 开 相 机 应 用 ,默认 只 能 拍摄 缩 略 图 这 样 的 低 分 辨 率 照 片 
片 会 保存 在 onActivityResult(...) 返 回 的 Intent 对 象 里 。 











而 且 照 


要 想 获 得 全 尺寸 照片 ， 就 要 让 它 使 用 文件 系统 存储 照片 。 这 可 以 通过 传人 保存 在 
MediaStore.EXTRA _0UTPUT 中 的 指向 存储 路 径 的 Uri 来 完成 。 这 个 Uri 会 指向 FileProvider 提 





供 的 位 置 。 





























编写 用 于 拍照 的 隐 式 intent， 如 代码 清单 16-8 所 示 。 拍 摄 的 照片 应 该 保存 在 mnPhotoFite 指 定 


的 地 方 。 同 时 ， 别 忘 了 检查 设备 上 是 否 安装 有 相机 应 用 ， 以 及 是 否 有 地 方 存储 照片 。( 要 确认 是 
否 有 可 用 的 相机 应 用 ,可 找 PackageManager 确 认 是 否 有 响应 相机 隐 式 intent 的 activity。 关 于 查询 











PackageManager 的 详细 内 容 ， 参 见 15.4.4 节 。 ) 


代码 清单 16-8 使 用 相机 intent ( CrimeFragment.java ) 


private static final int REQUEST DATE = 0; 
private static final int REQUEST CONTACT = 1; 
private static final int REQUEST PHOTO= 2; 


@Override 
public View onCreateView(layoutinflater inflater, ViewGroup container, 
Bundle savedinstanceState) { 


mPhotoButton = (imageButton) v.findViewByid(R.id.crime camera); 
final Intent captureImage = new Intent(MediaStore.ACTION IMAGE CAPTURE); 


boolean canTakePhoto = mPhotoFile != null && 
captureImage. resoLveActivity(packageManager) != null; 
mPhotoButton. setEnabled(canTakePhoto); 


mPhotoButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Uri uri = FileProvider.getUriForFile(getActivity(), 





"com.bignerdranch.android.criminalintent.fileprovider", mPhotoFile); 


captureImage.putExtra(MediaStore.EXTRA OUTPUT, uri); 
List<ResoLveInfo> cameraActivities = getActivity() 
.getPackageManager() .queryIntentActivities(captureImage， 
PackageManager .MATCH_DEFAULT_ONLY) ; 


for (ResoLveInfo activity : cameraActivities) { 


getActivity().grantUriPermission(activity.activityInfo.packageName， 


uri, Intent.FLAG GRANT_ WRITE_ URI_ PERMISSION); 
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startActivityForResuLt(captureImage，REQUEST_PHOT0) ; 


} 
}); 


mPhotoView = (imageView) v.findViewByid(R.id.crime photo); 


return v; 


} 

调用 FileProvider.getUriForFile(...) 会 把 本 地 文件 路 径 转 换 为 相机 能 看 见 的 Uri 形 
式 。 要 实际 写 入 文件 ， 还 需要 给 相机 应 用 权限 。 为 了 授权 ， 我 们 授予 FLAG_GRANT_WRITE_URI 
PERMISSION 给 所 有 cameraImage intent 的 目标 activity， 以 此 允许 它们 在 Uri 指 定 的 位 置 写 文 件 。 
当然 ,还 有 个 前 提 和 条件: 在 声明 FiteProvider 的 时 候 添加 过 android:grantUriPermissions 属 性 。 

运行 CriminalIntent 详 用 ， 点 击 相 机 按钮 启动 相机 应 用 ， 如 图 16-4 所 示 。 























图 16-4 ”打开 设备 上 的 相机 应 


二 





16.4 ”缩放 和 显示 位 图 


现在 ， 终 于 可 以 拍摄 陋习 现场 的 照片 并 保存 了 。 
有 了 有 照片 ， 接 下 来 就 是 找到 并 加 载 它 ， 然 后 展示 给 用 户 看 。 在 技术 实现 上 ， 这 需要 加 载 照片 
到 大 小 合适 的 Bitmap 对 象 中 。 要 从 文件 生成 Bitmap 对 象 ， 我 们 需要 BitmapFactory 类 : 


Bitmap bitmap = BitmapFactory.decodeFile(mPhotoFile.getPath()); 
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看 到 这 里 ， 有 没有 感觉 不 对 劲 ? 肯定 有 的 。 和 否则 依照 本 书 代码 风格 ， 上 述 代码 就 会 直接 加 粗 
印刷 ， 你 对 照 输入 就 行 了 。 

不 卖 关 子 了 ， 问 题 在 于 ， 介 绍 Bitmap 时 ， 我 们 提 到 “大 小 合适 ”。Bitmap 是 个 简单 对 象 ， 它 
只 存储 实际 像素 数据 。 也 就 是 说 ， 即 使 原始 照片 已 压缩 过 ,但 存 和 Bitmap 对 象 时 ， 文 件 并 不 会 
同样 压缩 。 因 此 ， 一 张 1600 万 像素 24 位 的 相机 照片 ( 存 为 PG 格式 大 约 5MB )， 一 旦 载 人 Bitmap 
对 象 ， 就 会 立即 膨胀 至 48MB 1 

这 个 问题 可 以 设法 解决 ,但 需要 手动 缩放 位 图 照片 。 具 体 做 法 就 是 ， 首 先 确 认 文 件 到 底 有 
多 大 ， 然 后 考虑 按照 给 定 区 域 大 小 合理 缩放 文件 。 最 后 ， 重 新 读 取 缩放 后 的 文件 ， 创 建 Bitmap 
对 象 。 

创建 名 为 PictureUtits 的 新 类 ， 并 在 其 中 添加 getScatLedBitmap(String，int，int) 缩 
放 方 法 ， 如 代码 清单 16-9 所 示 。 


代码 清单 16-9 创建 getScatedBitmap(...) 方 法 (PictureUtils.java) 


public class PictureUtils { 
public static Bitmap getScaledBitmap(String path, int destWidth, int destHeight) { 
// Read in the dimensions of the image on disk 
BitmapFactory .Options options = new BitmapFactory.0Options(); 
options.inJustDecodeBounds = true; 
BitmapFactory.decodeFile(path, options); 















































float srcWidth = options.outWidth; 
float srcHeight = options.outHeight; 


// Figure out how much to scale down by 

int inSampleSize = 1; 

if (srcHeight > destHeight || srcwidth > destwidth) { 
float heightScale = srcHeight / destHeight; 
float widthScale = srcWidth / destWwidth; 


inSampleSize = Math.round(heightScale > widthScale ? heightScale : 
widthScale); 
} 


options = new BitmapFactory .Options(); 
options.inSampleSize = inSampleSize; 


// Read in and create final bitmap 
return BitmapFactory.decodeFile(path, options); 


} 

上 述 方法 中 ，inSampleSize 值 很 关键 。 它 决定 着 缩 略 图 像素 的 大 小 。 假 设 这 个 值 是 1 的 话 ， 
就 表明 缩 略 图 和 原始 照片 的 水 平 像素 大 小 一 样 。 如 果 是 2 的 话 ， 它 们 的 水 平 像素 比 就 是 1 : 2。 
此 ，inSampLeSize 值 为 2 时 ， 缩 略图 的 像素 数 就 是 原始 文件 的 四 分 之 一 。 

问题 总 是 接 中 而 来 。 解 决 了 缩放 问题 ， 又 冒 出 了 新 间 题 ，fragment 刚 启动 时 ， 无 人 知道 
Photoview 究 竟 有 多 大 。onCreate(...)、onStart() 和 onResume() 方 法 启动 后 ， 才 会 有 首 个 
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实例 化 布局 出 现 。 也 就 在 此 时 , 显示 在 屏幕 上 的 视图 才 会 有 大 小 尺寸 。 这 也 是 出 现 新 问题 的 原因 。 

解决 方案 有 两 个 : 要 么 等 布局 实例 化 完成 并 显示 , 要 么 干脆 使 用 保守 估算 值 。 特定 条 件 下 ， 
尽管 估算 比较 主观 ， 但 确实 是 唯一 切实 可 行 的 办 法 。 再 添加 一 个 getScatedBitmap(String， 
Activity) 静 态 Bitmap 估 算 方法 ， 如 代码 清单 16-10 所 示 。 


代码 清单 16-10 ”编写 合理 的 缩放 方法 (PictureUtils.java ) 


public class PictureUtils { 
public static Bitmap getScaledBitmap(String path, Activity activity) { 
Point size = new Point(); 
activity.getWindowManager().getDefaultDisplay() 
.getSize(size); 




















return getScaledBitmap(path, size.x, size.y); 


} 
该 方法 先 确认 屏幕 的 尺寸 , 然后 按 此 缩放 图 像 。 这 样 ， 就 能 保证 载 和 的 ImageView 永 远 不 会 
过 大 。 无 论 如 何 ， 这 是 一 个 比较 保守 的 估算 ,但 能 解决 问题 。 
接 下 来 , 为 了 把 Bitmap 载 人 ImageView, 在 CrimeFragment.java 中 ， 添 加 刷新 mPhotoView 
的 方法 ， 如 代码 清单 16-11 所 示 。 


代码 清单 16-11 更 新 mPhotoView ( CrimeFragment.java ) 
private String getCrimeReport() { 








} 
private void updatePhotoView() { 
if (mPhotoFile == null || !mPhotoFile.exists()) { 
mPhotoView. setImageDrawable (nul1); 
} else { 


Bitmap bitmap = PictureUtils.getScaledBitmap( 
mpPhotoFile.getPath(), getActivity()); 
mPhotoView. setImageBitmap (bitmap); 


} 


然后 ， 分 别 在 onCreateView(...) 方 法 和 onActivityResult(...) 方 法 中 调用 
updatePhotoView() 方 法 ， 如 代码 清单 16-12 所 示 。 


代码 清单 16-12 ”调用 updatePhotoView() 方 法 ( CrimeFragment.java ) 


mPhotoButton.setOnClickListener(new View.OnClickListener() { 16 
GOverride 
public void onCLick(View v) { 





startActivityForResult(captureImage, REQUEST PHOTO); 


}); 
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mPhotoView = (ImageView) v.findViewById(R.id.crime photo); 


updatePhotoView(); 
return v; 

} 

@Override 


public void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (resultCode != Activity,RESULT OK) { 
return; 


} 

if (requestCode == REQUEST DATE) { 

} Lee (requestCode == REQUEST CONTACT && data != null) { 
} else if (requestCode == REQUEST_ PHOTO) { 


Uri uri = FileProvider.getUriForFile(getActivity(), 


"com.bignerdranch.android.criminalintent.fileprovider", 
mPhotoFile); 


getActivity().revokeUriPermission(uri， 
Intent.FLAG GRANT_ WRITE _ URI PERMISSION); 


updatePhotoView(); 
} 


既然 相机 已 保存 了 文件 , 那 就 再 次 调用 权限 ,关闭 文件 访问 。 再 次 运行 应 用 , 应 该 可 以 看 到 
已 拍照 片 的 缩 略 图 了 。 
































16.5 ”功能 声明 














应 用 的 拍照 功能 用 起 来 不 错 ， 但 还 有 一 件 事情 要 做 ， 告诉 潜在 用 户 应 用 有 拍照 功能 。 

假如 应 用 要 用 到 诸如 相机 、NFC， 或 者 任何 其 他 的 随 设备 走 的 功能 时 ， 都 应 该 要 让 Android 
系统 知道 这样 , 假如 设备 缺少 这 样 的 功能 , 类 似 Google Play 商店 的 安装 程序 就 会 拒绝 安装 应 用 。 

为 了 声明 应 用 要 使 用 相机 ， 在 AndroidManifestxml 中 加 入 <uses- feature> 标 签 ， 如 代码 清 
单 16-13 所 示 。 

















代码 清单 16-13 ”添加 <uses-feature> 标 签 ( AndroidManifest.xml ) 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.bignerdranch.android.criminalintent" > 


<uses-feature android:name="android.hardware. camera" 
android: required="false" 
/> 
注意 ， 我 们 在 代码 中 使 用 了 android:required 属 性 。 默 认 情 况 下 ， 声 明 要 使 用 某 个 设备 功 
能 后 ， 应 用 就 无 法 支持 那些 无 此 功能 的 设备 了 ,但 这 不 适用 于 CriminalIntent 应 用 。 这 是 因为 ， 

















| 
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resoLveActivity(..,) 方 法 可 以 判断 设备 是 否 支持 拍照 。 如 果 不 支持 ， 就 直接 禁用 拍照 按钮 。 
无 论 如 何 ， 这 里 设置 android:required 属 性 为 false，Android 系 统 因 此 就 知道 ， 尽 管 不 带 
相机 的 设备 会 导致 应 用 功能 缺失 ， 但 应 用 仍然 可 以 正常 安装 和 使 用 。 


16.6 ”挑战 练习 : 优化 照片 显示 


现在 虽然 能 够 看 到 拍摄 的 照片 ， 但 没 法 看 到 照片 细节 。 
请 创建 能 显示 放大 版 照片 的 DialogFragment 。 只 要 点 击 缩 略 图 ， 就 会 弹出 这 个 
DialogFragment， 让 用 户 查 看 放大 版 的 照片 。 


16.7 ”挑战 练习 :; 优化 缩 略图 加 载 


本 章 , 我 们 只 能 大 致 估算 缩 略 图 的 目标 尺寸 。 虽 说 这 种 做 法 可 行 且 实施 迅速 , 但 还 不 够 理想 。 

Android 有 个 现成 的 API 工 具 可 用 , 叫 作 ViewTree0bserver。 你 可 以 从 Activity 层 级 结构 中 
获取 任何 视图 的 ViewTree0bserver 对 象 : 

ViewTree0bserver observer = mImageView.getViewTree0bserver() 

你 可 以 为 ViewTree0bserver 对 象 设 置 包 括 0nGLobaLLayoutListener 在 内 的 各 种 监听 器 。 
使 用 OnGLobaLLayoutListener 监 听 器 ， 可 以 监听 任何 布局 的 传递 ， 控 制 事 件 的 发 生 。 

调整 代码 ， 使 用 有 效 的 mPhotoView 尺 寸 ， 等 到 有 布局 切换 时 再 调用 updatePhotoView() 
方法 。 
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双 版 面 主 从 用 尸 界 面 








本 章 , 为 了 适应 平板 设备 ,我 们 改造 CriminalIntent 应 用 的 用 户 界面 ， 让 用 户 能 同时 看 到 列表 





和 明细 界面 并 与 它们 交互 。 


(master-detail interface )。 





Criminallntent 





图 17-1 展 示 了 这 样 的 列表 明细 界面 ， 也 可 称 其 为 主 从 用 户 界 面 


dM 7:00 


二 NEW CRIME ”SHOW SUBTITLE 





Scooter stolen while going 
to the restroom 


Sun May 29 15:50:01 EDT 2016 
Paper clip Ponzi 
scheme 9 
Tue Jun 28 05:36:04 EDT 

2016 


Instagram photos at 
beach on sick day 


Thu Sep 08 10:09:09 EDT 2016 


Fragment fraud 
Wed Nov 30 22:18:27 EST 2016 


Popcorn left 
unattended, 9 
microwaveonfire EO 


Mon Dec 12 13:01:10 








TITLE 


| Popcorn left unattended, microwave on fire 





[oj 
DETAILS 
MON DEC 12 13:01:10 EST 2016 
Solved 
CHOOSE SUSPECT 
SEND CRIME REPORT 








图 17-1 同时 显示 列表 和 明细 的 用 户 界面 


本 章 的 代码 验证 需要 使 用 平板 设备 或 AVD。 要 创建 平板 AVD, 首先 选择 Tools 一 > Android 一 AVD 





Manager 菜 单项 ， 然 后 点 击 +Create Virtual Device... 按 钮 ， 在 弹出 的 界面 选择 Tablet 类 别 。 选 择 目 标 虚 
拟 硬件 配置 后 ， 点 击 Next 按 钮 继续 ， 如 图 17-2 所 示 。 最 后 ， 确 认 API 级 别 至 少 为 21， 点 击 Finish 按 钮 











完成 。 
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Virtual Device Configuration 





Select Hardware 


YX Android Studio 


Choose a device definition 


Q- 





- = [DD Nexus 7 
Category | Namev l Size | Resolution | Density 
Tv Pixel C 9.94" 2560x1800 xhdpi 
Wear Nexus 9 8.86" 2048x1536 xhdpi 0 
Size: large 
Phone Nexus 7 (2012) 7.0" 800x1280 tvdpi a ee 
7.02" B1920px 

Nexus 10 10.05" 2560x1600 xhdpi 

7" WSVGA (Tablet) 7.0" 600x1024 mdpi 

10.1" WXGA (Tablet) 10.1" 800x1280 mdpi 


New Hardware Profile Import Hardware Profiles [0] Clone Device... 





Previous Finish 


图 17-2 AVD 平 板 设备 选择 
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在 手机 设备 上 ，CrimeListActivity 生 成 的 是 单 版 面 ( single-pane ) 布局 。 在 平板 设备 上 ， 


为 了 同时 显示 主 从 视图 ， 我 们 需要 它 生 成 双 版 面 (two-pane ) 布局 。 


在 双 版 面 布局 中 , CrimeListActivity 将 同时 托管 CrimeListFragment 和 CrimeFragment， 


如 图 17-3 所 示 。 


手机 平板 
CrimeListActivity ”CrimePagerActivity CrimeListActivity 





CrimeListFragment 


CrimeFragment 


图 17-3 ”不 同类 型 的 布局 


CrimeListFragment CrimeFragment 
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要 实现 双 版 面 布局 ， 需 完成 如 下 任务 : 

口 修改 SingleFragmentActivity， 不 再 人 硬 编码 实例 化 布局 ; 

口 创建 包含 两 个 fragment 容 右 的 布局 ; 

口 修改 CrimeListActivity， 实 现在 手机 设备 上 实例 化 单 版 面 布 局 ， 在 平板 设备 上 实例 化 
双 版 面 布局 。 





























17.1.1 修改 SingleFragmentActivity 





CrimeListActivity 是 SingleFragmentActivity 的 子 类 。 当 前 ，SingleFragmentActivity 
只 能 实例 化 activity fragment.xml 布 局 。 为 了 使 SingleFragmentActivity 类 更 加 灵活 易 用 ,我 们 
让 它 的 子 类 自己 提供 布局 资源 ID。 

在 SingleFragmentActivityjava 中 ， 添 加 一 个 protected 方 法 , 返回 activity 需 要 的 布局 资源 ID， 
如 代码 清单 17-1 所 示 。 


代码 清单 17-1 增加 SingleFragmentActivity 类 的 灵活 性 ( SingleFragmentActivity.java ) 
public abstract class SingleFragmentActivity extends AppCompatActivity { 





protected abstract Fragment createFragment(); 


@LayoutRes 
protected int getLayoutResId() { 
return R.layout.activity fragment; 


} 


@Override 
public void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(getLayoutResId() ); 


FragmentManager fm = getSupportFragmentManager(); 


} 

现在 , 虽然 SingleFragmentActivity 抽 象 类 的 功能 和 以 前 一 样 , 但是， 如 果 不 想 再 使 用 固 
定 不 变 的 activity_ fragmentxml 布 局 ， 它 的 子 类 可 以 选择 覆盖 getLayoutResId ( ) 方 法 返回 所 需 布 
局 。getLayoutResId ( ) 方 法 使 用 了 QLayoutRes 注 解 。 这 告诉 Android Studio， 任 何 时 候 ， 该 实 
现 方法 都 应 该 返回 有 效 的 布局 资源 ID。 


17.1.2 创建 包含 两 个 fragment 容器 的 布局 


在 项 目 工 具 窗 口中 ， 右 键 单 击 res/layout/ 目 录 ， 新 建 一 个 XML 文 件 。 在 弹出 的 新 建 XML 文 件 
界面 ， 指 定 资 源 类 型 为 Layout， 命 名 文件 为 activity_twopane.xml， 然 后 选择 LinearLayout 作 为 
根 元 素 ， 最 后 单 击 Finish 按 钮 完成 。 
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参照 图 17-4， 完 成 双 版 面 布局 的 XML 内 容 定义 


LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android:divider="?android:attr/dividerHorizontal" 
android:showDividers="middle" 
android:orientation="horizontal" 


FrameLayout FrameLayout 
android:id="@+id/fragment_container" android:id="@+id/detail_fragment_container" 
android: layout_width="Qdp" android: layout_width="Qdp" 


android: layout_height="match_parent" android: layout_height="match_parent" 
android: layout_weight="1" android: layout_weight="3" 








图 17-4 包含 两 个 fagment 容 器 的 布局 (layout/activity_twopane.xml ) 


， 布 局 定义 的 第 一 个 FrameLayout 也 有 一 个 fragment_container 布 局 资源 ID ， 因 此 
Bo es onCreate(...) 方 法 的 相关 代码 能 够 像 以 前 一 样 工 作 。activity 创 建 
后 ，createFragment( ) 方 法 返回 的 fagment 尾 会 出 现在 屏幕 左 侧 的 版 面 中 。 
要 测试 新 建 布局 , 在 CrimeListActivity 类 中 覆盖 getLayoutResId ( ) 方 法 , 返回 R. layout. 
activity twopane 资 源 ID ， 如 代码 清单 17-2 所 示 。 


代码 清单 17-2 使 用 双 版 面 布局 ( CrimeListActivity.java ) 


public class CrimeListActivity extends SingleFragmentActivity { 


@Override 
protected Fragment createFragment() { 
return new CrimeListFragment(); 


} 


@Override 
protected int getLayoutResId() { 
return R.Layout,activity_ twopane; 
} 
} 


在 平板 设备 或 AVD 上 运行 CriminalIntent 应 用 , 确认 可 以 看 到 如 图 17-5 所 示 的 用 户 界面 。 注意， 
右边 的 明细 版 面 什么 也 没 显示 。 即 使 点 击 任意 列表 项 ， 也 无 法 显示 对 应 的 crime 明 细 信 息 。 本 章 
稍 后 会 完成 crime 明 细 fragment 容 需 的 编码 及 设置 工作 。 









































274 第 17 章 双 版 面 主 从 用 户 界面 





WA 700 


Criminallntent 十 NEw cRIME SHOW SUBTITLE 


Scooter stolen while going 
to the restroom 


Sun May 29 15:50:01 EDT 2016 
Paper clip Ponzi 
scheme 9o 


Tue Jun 28 05:36:04 EDT 
2016 


Instagram photos at 
beach on sick day 


Thu Sep 08 10:09:09 EDT 2016 


Fragment fraud 
Wed Nov 30 22:18:27 EST 2016 
Popcorn left 


unattended, 9 
microwave onfire YO 


Thu Dec 08 10:19:45 EST 








图 17-5 ”平板 设备 上 的 双 版 面 布局 


当前 ,无 论 是 在 手机 还 是 在 平板 设备 上 ，CrimeListActivity 都 会 生成 双 版 面 的 用 户 界面 。 
下 一 节 将 使 用 别名 资源 来 解决 这 个 问题 。 


17.1.3 ”使 用 别名 资源 


别名 资源 是 一 种 指向 其 他 资源 的 特殊 资源 。 它 存放 在 res/values/ 目 录 下 ， 并 按照 约定 定义 在 
refs.xml 文 件 中 。 

接 下 来 的 任务 就 是 让 CrimeListActivity 基 于 不 同 的 设备 使 用 不 同 的 布局 文件 。 这 实际 类 
似 于 前 面 章节 对 水 平 布局 和 竖 直 布局 的 选择 和 控制 : 使 用 资源 修饰 符 。 

让 res/layout/ 目 录 中 的 文件 使 用 资源 修饰 符 虽 然 可 行 ， 但 也 有 缺点 。 最 明显 的 缺点 就 是 数据 
宛 余 ， 因 为 每 个 布局 文件 都 要 复制 一 份 。 例 如 ， 如 果 想 使 用 activity_masterdetaiLxml 布 局 文件 ， 
就 需要 将 activity fragment.xml 复制 到 res/layoutactivity masterdetailLxml 中 ， 并 且 将 activity 
twopane.xml 复 制 到 res/layout-sw600dp/activity_masterdetail.xml 中 ( 稍 后 会 提 到 sw600dp 的 作用 )。 

要 解决 上 述 问题 , 可 以 使 用 别名 资源 。 本 小 节 将 分 别 创建 用 于 手机 指向 activity_fragment. xml 
布局 的 别名 资源 ， 以 及 用 于 平板 指向 activity_twopane.xml 布 局 的 别名 资源 。 

在 项 目 工 具 窗 口中 , 右键 单 击 res/values/ 目 录 , 新 建 values 资 源 文 件 。 在 弹出 的 新 建 XML 文 件 
界面 ， 选 择 资 源 类 型 为 Values ， 并 将 文件 命名 为 refs.xml。 确 认 新 建 的 文件 不 带 任何 修饰 符 ， 最 
后 单 击 Finish 按 钮 。 参 照 代码 清单 17-3 ， 在 新 建 的 refs.xml 中 添加 item 节 点 定义 。 


代码 清单 17-3 ”创建 默认 的 别名 资源 值 (res/values/refs.xml ) 


<resources> 
































































































































<item name="activity masterdetail" type="layout">@layout/activity fragment</item> 


</resources> 
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别名 资源 指向 了 单 版 面 布局 资源 文件 。 别 名 资源 自身 也 具有 资源 ID: R.Layout.activity 
masterdetaiL。 注 意 ， 别 名 的 type 属 性 决定 资源 ID 属于 什么 内 部 类 。 即 使 别名 资源 自身 在 
res/values/ 目 录 中 ， 它 的 资源 ID 依然 属于 R.Layout 内 部 类 。 

修改 CrimeListActivity 类 , 以 R.Layout .activity _masterdetail 资 源 ID 替 换 R.layout. 
activity _ fragment， 如 代码 清单 17-4 所 示 。 


代码 清单 17-4 ”再 次 切换 布局 ( CrimeL istActivity.java ) 


@Override 
protected int getLayoutResId() { 
return R.layout.activity twepane;masterdetail; 

















} 


运行 CriminalIntent 应 用 并 验证 别名 资源 的 使 用 ,一切 正常 的 话 , CrimeListActivity 应 该 再 
次 生成 了 单 版 面 布局 。 


17.1.4 创建 平板 设备 专用 可 选 资源 


因为 res/values/ 目 录 中 的 别名 资源 是 系统 默认 的 别名 资源 ， 所 以 CrimeListActivity 生 成 了 
单 版 面 布局 。 

现在 ,创建 一 个 大 屏幕 设备 专用 的 可 选 别 名 资源 ， 让 activity_masterdetail 别 名 资源 指 
向 activity_ twopane.xml 双 版 面 布局 资源 。 

在 项 目 工具 窗口 中 , 右键 单 击 res/values/ 目 录 , 弹出 如 图 17-6 所 示 的 新 建 资源 文件 窗口 。 资 源 
文件 名 和 目录 名 依然 分 别 是 refs.xml 和 values， 但 这 次 要 用 >> 按 钮 把 Available qualifiers 窗 口中 的 
Screen Width 选 到 右边 窗口 去 。 














@e@ New Resource File 
File name: refs.xml 
Source set: main ?| 


Directory name: ， values-sw600dp 

Available qualifiers: Chosen qualifiers: 
@: Country Code 畦 sw600dp 

@ Network Code 

网 Locale 

晶 Layout Direction 
screen Height 

园 Size 

团 Ratio 
局 | Orientation 

加 Ul Mode 

© Night Mode 

区 Density 

® Touch Screen 

局 Keyboard 


Smallest screen width: 
600 


>> 


? cancel | BD 


图 17-6 ”添加 资源 修饰 符 





可 以 看 到 ,资源 修饰 符 处 要 求 指定 Smallest Screen Width 的 数值 ,输入 600 后 点 击 OK 按钮 完成 。 
在 随后 打开 的 新 建 资 源 文件 中 ， 添 加 activity masterdetaiL 别 名 资源 指向 activity twopane. 
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xml， 如 代码 清单 17-5 所 示 。 


代码 清单 17-5 ”用 于 大 屏幕 设备 的 可 选 资源 ( res/values-sw600dp/refs.xml ) 


<resources> 





<item name="activity masterdetail" type="layout">@layout/activity twopane</item> 


</resources> 
对 于 上 述 新 增 别名 资源 ， 我 们 的 目标 是 : 
口 对 于 小 于 指定 尺寸 的 设备 ， 使 用 activity_fragment.xml 资 源 文件 ; 
口 对 于 大 于 指定 尺寸 的 设备 ， 使 用 activity_twopane.xml 资 源 文件 。 
Android 只 提供 一 部 分 的 资源 适 配 机 制 。 配 置 修饰 符 -sw699dp 的 作用 是 : 如 果 设 备 尺 寸 大 于 
某 个 指定 值 ， 就 使 用 对 应 的 资源 文件 。sw 是 smallest width ( 最 小 宽度 ) 的 缩写 。 虽 然 字 面 上 是 宽 
度 的 含义 ， 但 它 实际 指 的 是 屏幕 的 最 小 尺寸 (dimension )， 因 而 sw 与 设备 的 当前 方向 无 关 。 

在 确定 可 选 资源 时 ，-sw600dp 配 置 修饰 符 表 明 : 对 任何 最 小 尺寸 为 600dp 或 更 高 dp 的 设备 ， 
都 使 用 该 资源 。 对 于 指定 平板 的 屏幕 尺寸 规格 来 说 ， 这 是 一 种 非常 好 的 做 法 。 

那 另 一 部 分 的 资源 适 配 怎么 处 理 呢 ? 对 于 希望 使 用 activity_fragment.xml 的 小 尺寸 设备 要 怎 
么 做 呢 ? 这 好 办 ，Android 是 这 样 判断 的 : 既然 设备 尺寸 小 于 -sw600dp 配 置 修饰 符 的 指定 值 ， 那 
就 使 用 默认 的 activity_ fragment.xml 资 源 文 件 。 

分 别 在 手机 和 平板 上 运行 CriminalIntent 应 用 ， 确 认 单 双 版 面 布局 都 能 正常 显示 。 













































































17.2 ”activity: fragment 的 托管 


处 理 完 单 双 版 面 布 局 的 显示 ， 就 可 以 着 手 将 CrimeFragment 添 加 给 crime 明 细 fragment 容 右 ， 
让 CrimeListActivity 展 示 一 个 完整 的 双 版 面 用 户 界面 。 

你 可 能 会 认为 ， 只 需 再 为 平板 设备 实现 一 个 CrimeHoLder,.onCLick(View) 监 听 咒 方法 就 行 
了 。 这 样 , 无 需 启动 新 的 CrimePagerActivity, onCLick(View) 方 法 会 获取 CrimeListActivity 
的 FragmentManager ,然后 提交 一 个 fragment 事 务 ,将 CrimeFragment 添 加 到 明细 fragment 容 器 中 。 

这 种 设想 的 具体 实现 代码 如 下 (CrimeListFragment .CrimeHoLder ): 


public void onClick(View view) { 
// Stick a new CrimeFragment in the activity's Layout 
Fragment fragment = CrimeFragment.newInstance(mCrime.getId()); 
FragmentManager fm = getActivity().getSupportFragmentManager(); 
fm.beginTransaction() 
.add(R.id.detail fragment container, fragment) 
.Commit(); 
































小 

虽然 行 得 通 ， 但 做 法 很 老 套 。fragment 天 生 是 个 独立 的 开发 构件 。 如 果 要 开发 fragment 用 来 
添加 其 他 fragment 到 activity 的 FragmentManager， 那 么 这 个 fragment 就 必须 知道 托管 activity 是 如 
何 工 作 的 。 结 果 ， 该 fagment 就 再 也 无 法 作为 独立 的 开发 构件 使 用 了 。 
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以 上 述 代 码 为 例 , CrimeListFragment 将 CrimeFragment 添 加 给 了 CrimeListActivity, 并 
且 认 为 CrimeListActivity 的 布局 里 包含 detail fragment_container 。 但 实际 上 ， 
CrimeListFragment 根 本 就 不 应 关心 这 些 ， 这 都 是 其 托管 activity 应 该 处 理 的 事情 。 

为 了 让 fragment 独 立 ， 我 们 可 以 在 fragment 中 定义 回调 接口 ， 委 托 托管 activity 来 完成 那些 不 
应 由 fragment 处 理 的 任务 。 托 管 activity 将 实现 回调 接口 ， 履 行 托管 fagment 的 任务 。 




















fragment 回调 接口 


要 委托 工作 任务 给 托管 activity， 通 常 的 做 法 是 由 fragment 定 义 名 为 CaLtLbacks 的 回调 接口 。 
回调 接口 定义 了 fragment 委 托 给 托管 activity 处 理 的 工作 任务 。 任 何 打算 托管 目标 fragment 的 
activity 都 必须 实现 它 。 

有 了 回调 接口 ， 就 不 用 关心 谁 是 托管 者 ，fragment 可 以 直接 调用 托管 activity 的 方法 。 

1. 实现 CrimeListFragment,.CaLLbacks 回 调 接口 

为 了 实现 Callbacks 接 口 , 首先 要 定义 一 个 成 员 变量 , 用 于 存放 实现 CaLLbacks 接 口 的 对 象 。 
然后 将 托管 activity 强 制 类 型 转换 为 CaLLbacks 对 象 并 赋值 给 CaLLbacks 类 型 变量 。 

activity 赋 值 是 在 Fragment 的 生命 周期 方法 中 处 理 的 : 

public void onAttach(Context context ) 

该 方法 是 在 ffagment 附 加 给 activity 时 调用 的 ， 当 然 fragment 是 否 保留 并 不 重要 。 记 住 ， 
Activity 是 Context 的 子 类 ， 所以，onAttach 可 以 传人 Context 参 数 ， 这 确实 很 灵活 。 请 确保 使 
用 onAttach (Context) 方 法 , 而 不 是 已 废弃 的 onAttach(Activity) 方 法 (将 来 可 能 会 被 移 除 )。 

类 似 地 ， 在 相应 的 生命 周期 销毁 方法 中 ,将 Callbacks 变 量 设置 为 null。 

public void onDetach() 

这 里 将 变量 清空 的 原因 是 ， 随 后 再 也 无 法 访问 该 activity 或 指望 它 继续 存在 了 。 

在 CrimeListFragment.java 中 ， 添 加 CaLLbacks 接 口 。 另 外 添加 一 个 mCaLLbacks 变 量 并 覆盖 
onAttach(Context) 和 onDetach () 方 法 ， 完 成 变量 的 赋值 与 清空 ， 如 代码 清单 17-6 所 示 。 


























































































































代码 清单 17-6 添加 回调 接口 ( CrimeListFragment.java ) 


public class CrimeListFragment extends Fragment { 


private boolean mSubtitleVisible; 
private Callbacks mCallbacks; 


天 汪 订 
* Required interface for hosting activities 
*/ 
public interface Callbacks { 
void onCrimeSelected(Crime crime); 


} 


@Override 
public void onAttach(Activity activity) { 
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super.onAttach (Context); 
mCallbacks = (Callbacks) activity; 
} 


@Override 

public void onCreate(Bundle savedInstance9tate) { 
super.onCreate(savedInstanceState); 
setHasOptionsMenu(true); 

} 

@Override 

public void onSaveInstanceState(Bundle outState) { 
super.onSaveInstanceState(outState); 


outState.putBoolean(SAVED SUBTITLE VISIBLE, mSubtitleVisible); 
} 


@Override 

public void onDetach() { 
super .onDetach(); 
mCallbacks = null; 


} 

现在 ，CrimeListFragment 有 办 法 调用 托管 activity 方 法 了 。 男 外 ， 它 也 不 关心 托管 activity 
是 谁 。 只 要 托管 activity 实 现 了 CrimeListFragment.Callbacks 接 口 ，CrimeListFragment 中 的 
一 切 代 码 行 为 就 都 可 以 保持 不 变 。 
注意 ， 未 经 类 安全 性 检查 ，CrimeListFragment 就 将 托管 activity 强 制 转 换 为 了 CrimeList- 
Fragment.Callbacks 对 象 。 这 意味 着 ， 托 管 activity 必 须 实现 CrimeListFragment.Callbacks 
接口 。 这 并 非 是 不 良 的 依赖 关系 ， 但 记录 下 它 非常 重要 。 

接 下 来 , 在 CrimeListActivity 类 中 ， 实 现 CrimeListFragment ,CaLLbacks 接 口 ， 如 代码 
清单 17-7 所 示 。 和 暂时 不 用 理会 onCrimeSetected(Crime) 空 方法 ， 稍 后 再 来 处 理 。 



































代码 清单 17-7 ”实现 回调 接口 ( CrimeListActivity.java ) 


public class CrimeListActivity extends SingleFragmentActivity 
implements CrimeListFragment.Callbacks { 


@Override 
protected Fragment createFragment() { 
return new CrimeListFragment(); 


} 


@Override 
protected int getLayoutResId() { 
return R.layout.activity masterdetaitL 


} 


@Override 
public void onCrimeSelected(Crime crime) { 


} 
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最 终 ， 在 用 户 创 建新 crime 记 录 时 ，CrimeListFragment 将 在 CrimeHolder.onClick(...) 
方法 里 调用 onCrimeSelected(Crime) 方 法 。 现 在 ， 先 思考 如 何 实 现 CrimeListActivity. 
onCrimeSelected(Crime) 方 法 。 

onCrimeSelected(Crime) 方 法 被 调用 时 ，CrimeListActivity 需 要 完成 以 下 二 选 一 任务 : 

口 如 果 使 用 手机 用 户 界面 布局 ， 启 动 新 的 CrimePagerActivity; 
口 如 果 使 用 平板 设备 用 户 界面 布局 ,将 CrimeFragment 放 和 人 detail fragment container 中 。 

是 实例 化 手机 界面 布局 还 是 平板 界面 布局 ， 可 以 检查 布局 ID ; 但 是 推荐 检查 布局 是 否 包 含 
detaiL_ fragment_container。 这 是 因为 布局 文件 名 随时 会 变 ， 并 且 我 们 也 不 关心 布局 是 从 哪 
个 文件 实例 化 产生 。 我 们 只 需 知 道 ， 布 局 文件 是 否 包含 可 以 放 和 人 人 CrimeFragment 的 detailL 
fragment_container。 

如 果 包 含 ， 那 就 创建 一 个 fragment 事 务 ， 将 我 们 需要 的 CrimeFragment 添 加 到 detail_ 
fragment container 中 。 如 果 之 前 就 有 CrimeFragment， 应 首先 移 除 它 。 

在 CrimeListActivity.java 中 , 实现 onCrimeSelected(Crime) 方 法 , 按照 不 同 的 布局 界面 分 别 
处 理 ， 如 代码 清单 17-8 所 示 。 


代码 清单 17-8 有 条 件 的 CrimeFragment 启 动 ( CrimeListActivityjava ) 


GOverride 
public void onCrimeSelected(Crime crime) { 
if (findViewById(R.id.detail fragment container) == null) { 
Intent intent = CrimePagerActivity.newIntent(this, crime.getId()); 
startActivity(intent); 
} else { 
Fragment newDetail = CrimeFragment.newInstance(crime.getId()); 






















































































getSupportFragmentManager() .beginTransaction() 
‘replace(R.id.detail fragment container, newDetail) 
.Commit(); 


} 


最 后 , 在 CrimeListFragment 类 中 , 在 启动 新 的 CrimePagerActivity 处 调用 onCrimeSelected 
(Crime) 方 法 。 

在 CrimeListFragment.java 中 , 修改 CrimeHolder.onClick(View) 和 on0ptionsItemSelected 
(MenuItem) ， 以 调用 Callbacks .onCrimeSelected(Crime) 方 法 ， 如 代码 清单 17-9 所 示 。 


代码 清单 17-9 ”调用 全 部 回调 方法 ( CrimeListFragment.java ) 


GOverride 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.new crime: 
Crime crime = new Crime(); 
CrimeLab.get(getActivity()).addCrime(crime); 
. 3 A 
I ( 中 ivity() Ye rdgO); 
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updateUI() ; 
mCaLLbacks.onCrimeSeLected(crime) ; 
return true; 


} 


private class CrimeHolder extends RecyclerView.ViewHolder 
implements View.OnClickListener { 
@Override 
public void onClick(View view) { 
I i CE Re I ( Activity 人 cri rdg); 
Activity (3 ); 


mCallbacks .onCrimeSelected(mCrime); 


} 

在 on0ptionsItemSeLected(MenuItem) 方 法 中 调用 回调 方法 时 ， 只 要 新 增 crime 记 录 ，crime 
列表 就 会 立即 重新 加 载 。 这 很 有 必要 ， 因 为 在 平板 设备 上 ， 新 增 crime 记 录 后 ，crime 列 表 依然 可 
见 ; 而 在 手机 设备 上 ，crime 明 细 界 面 会 在 列表 界面 之 前 出 现 ， 列 表 项 的 刷新 可 以 很 灵活 地 处 理 。 

在 平板 设备 上 运行 CriminalIntent 应 用 。 添 加 一 条 crime 记 录 ， 可 以 看 到 ，detaitL fragment _ 
container 容 器 中 立即 显示 了 新 的 CrimeFragment 视 图 。 然 后 ， 尝 试 查看 其 他 旧 记 录 以 观察 
CrimeFragment 视 图 的 切换 ， 如 图 17-7 所 示 。 


























BM LRA 


Criminalintent 十 NEWCRIME ”SHOW SUBTITLE 


Scooter stolen while going 
to the restroom | TITLE 


55 j 
ME Popcorn left unattended, microwave on fire 


Paper clip Ponzi 


scheme [oj 

Tue Jun 28 05:36:04 EDT 

2016 DETAILS 

Instagram photos at MON DEC 12 13:01:10 EST 2016 


beach on sick day 
Solved 
Thu Sep 08 10:09:09 EDT 2016 


CHOOSE SUSPECT 
Fragment fraud 


Wed Nov 30 22:18:27 EST 2016 SEND CRIME REPORT 


Popcorn left 


unattended, 9 
tO 


microwave on fire 
Mon Dec 12 13:01:10 





图 17-7 已 关联 的 主 界面 和 从 界面 


看 上 去 真 不 错 ! 不 过 ， 还 不 够 完美 : 如 果 修 改 crime 明 细 内 容 ， 列 表 项 并 不 会 显示 最 新 内 容 。 
当前 ， 在 CrimeListFragment.onResume() 方 法 中 ， 只 有 新 添加 crime 记 录 ， 我 们 才能 立即 刷新 
显示 列表 项 界面 。 但 是 在 平板 设备 上 ，CrimeListFragment 和 CrimeFragment 同 时 可 见 。 因 此 ， 






























































17.2 activity: 人 fragment 的 托管 者 281 








江 


当 CrimeFragment 出 现时 ，CrimeListFragment 不 会 暂停 一 一 没有 和 暂停 怎 会 有 恢复 ?这 就 
crime 列 表 项 不 能 刷新 的 根本 原因 。 

下 面 ， 我 们 在 CrimeFragment 中 添加 男 一 个 回调 接口 来 修正 这 个 问题 。 

2. 实现 CrimeFragment .CaLLbacks 回 调 接口 

CrimeFragment 类 中 定义 的 接口 如 下 : 


public interface Callbacks { 
void onCrimeUpdated(Crime crime); 











} 

crimeFragment 如 果 要 刷新 数据 ， 需 要 做 两 件 事 。 首 先 ， 既 然 CriminalIntent 应 用 的 数据 源 是 
SQLite 数 据 库 ， 那 么 它 需 要 把 Crime 保 存 到 CrimeLab 里 。 然 后 ，CrimeFragment 类 会 调用 托管 
activity 的 onCrimeUpdated(Crime) 方 法 。CrimeListActivity 类 会 负责 实现 onCrimeUpdated 
(Crime) 方 法 ， 从 数据 库 获 取 并 展示 最 新 数据 ， 重 新 加 载 CrimeListFragment 的 列表 。 

实现 CrimeFragment 的 接口 之 前 ， 先 把 CrimeListFragment.updateUI() 方 法 修改 为 
CrimeListActivity 可 以 调用 的 公共 方法 ， 如 代码 清单 17-10 所 示 。 
代码 清单 17-10 ”修改 updateUI() 方 法 的 可 见 性 ( CrimeListFragment.java ) 

private public void updateUI() { 



































} 

然后 ， 在 CrimeFragment.java 中 ， 添 加 回调 方法 接口 以 及 mCallbacks 成 员 变 量 ， 并 实现 
onAttach(... ) 方 法 和 onDetach() 方 法 ， 如 代码 清单 17-11 所 示 。 
代码 清单 17-11 新 增 CrimeFragment 回 调 接 口 ( CrimeFragment.java ) 


private ImageButton mPhotoButton,; 
private ImageView mPhotoView; 
private Callbacks mCallbacks; 


水 
* Required interface for hosting activities 
*/ 
public interface Callbacks { 
void onCrimeUpdated (Crime crime); 


} 


public static CrimeFragment newInstance(UUID crimeId) { 


} 


@Override 

public void onAttach(Context context) { 
super.onAttach (context); 
mCallbacks = (Callbacks) context; 

} 


GOverride 
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public void onCreate(Bundle savedInstanceState) { 


} 


@Override 
public void onPause() { 


} 


@Override 

public void onDetach() { 
super.onDetach(); 
mCallbacks = null; 

} 


然后 在 CrimeListActivity 类 中 实现 CrimeFragment.Callbacks 接 口 ， 以 实现 在 onCrime- 
Updated(Crime) 方 法 中 重新 加 载 crime 列 表 ， 如 代码 清单 17-12 所 示 。 


代码 清单 17-12 ”刷新 显示 crime 列 表 ( CrimeListActivityjava ) 


public class CrimeListActivity extends SingLeFragmentActivity 
impLements CrimeListFragment.Callbacks, CrimeFragment.Callbacks { 





public void onCrimeUpdated(Crime crime) { 
CrimeListFragment listFragment = (CrimeListFragment) 
getSupportFragmentManager() 
.findFragmentById(R.id.fragment container); 
listFragment.updateUI(); 


} 
托管 CrimeFragment 的 所 有 activity 都 必须 实现 CrimeFragment.CaLLbacks 接 口 。 因 而 在 
CrimePagerActivity 中 提供 一 个 空 接口 实现 ， 如 代码 清单 17-13 所 示 。 





代码 清单 17-13” 空 接口 实现 ( CrimePagerActivity.java ) 
public class CrimePagerActivity extends AppCompatActivity 
impLements CrimeFragment ,CaLLbacks { 
@Override 
public void onCrimeUpdated(Crime crime) { 
} 
小 
CrimeFragment 有 两 项 重复 性 任务 : 在 CrimeLab 中 保存 mCrime ， 以 及 调用 mCaLLbacks , 
onCrimeUpdated(Crime)。 添 加 一 个 便利 方法 处 理 它们 ， 如 代码 清单 17-14 所 示 。 
代码 清单 17-14 ”新 增 updateCrime() 方 法 ( CrimeFragment.java ) 


@Override 
public void onActivityResult(int requestCode, int resultCode, Intent data) { 








} 
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private void updateCrime() { 
CrimeLab.get(getActivity()).updateCrime(mCrime); 
mCallbacks .onCrimeUpdated (mCrime); 

} 


private void updateDate() { 
mDateButton.setText (mCrime.getDate().toString()); 
} 


在 CrimeFragment.java 中 ， 如 果 Crime 对 象 的 标题 或 问题 处 理 状 态 有 变动 ， 触 发 调用 
updateCrime() 方 法 ， 如 代码 清单 17-15 所 示 。 




















代码 清单 17-15 ”调用 onCrimeUpdated(Crime) 方 法 (CrimeFragment.java ) 


GOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


mTitleField.addTextChangedListener(new TextWatcher() { 


@Override 

public void onTextChanged(CharSequence s, int start, int before, int count) { 
mCrime.setTitle(s.toString()); 
updateCrime(); 


2) 


msolvedCheckbox. setonCheckedChangeListener (new OnCheckedChangeListener() { 
@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
mCrime.setSolved(isChecked); 
updateCrime(); 
}); 
} 
在 onActivityResult(...) 方 法 中 ，Crime 对 象 的 记录 日 期 、 现 场 照 片 以 及 嫌疑 人 都 有 可 能 
发 生变 化 , 因此 ,还 需 在 该 方法 中 调用 updateCrime() 方 法 。 当 前 ，crime 现 场 照 片 以 及 嫌疑 人 并 
没有 出 现在 列表 项 视图 中 , 但 并 排 的 CrimeFragment 视 图 应 该 显示 了 这 些 更 新 , 如 代码 清单 17-16 
所 示 。 


代码 清单 17-16 再 次 调用 updateCrime() 方 法 (CrimeFragment.java ) 

















Goverride 

public void onActivityResult(int requestCode, int resultCode, Intent data) { 
if 
if (requestCode == REQUEST DATE) { 





Date date = (Date) data 
.getSerializableExtra(DatePickerFragment.EXTRA DATE); 
mCrime.setDate(date); 
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updateCrime(); 
updateDate(); 
} else if (requestCode == REQUEST CONTACT && data != null) { 


try { 
String suspect = c.getString(0); 
mCrime.setSuspect(suspect); 
updateCrime(); 
mSuspectButton. setText (suspect); 


} finally { 
c.close(); 


} else if (requestCode == REQUEST PHOTO) { 


getActivity().revokeUriPermission(uri, 
intent.FLAG GRANT WRiTE URi PERMiSSiON); 





updateCrime(); 
updatePhotoView(); 


} 

在 平板 设备 上 运行 CriminalIntent 应 用 。 确 认 当 CrimeFragment 视 图 中 发 生 任 何 变化 时 ， 
RecyclerView 视 图 都 能 够 刷新 显示 。 然 后 ， 在 手机 上 运行 CriminalIntent 应 用 ， 确 认 一 切 正常 。 

至 此 ，CriminalIntent 应 用 终于 能 同时 支持 手机 和 平板 了 。 


17.3 ”深入 学 习 : 设备 屏幕 尺寸 的 确定 


Android 3.2 之 前 ， 屏 幕 大 小 修饰 符 是 基于 设备 的 屏幕 大 小 来 提供 可 选 资源 的 。 屏 幕 大 小 修饰 
符 将 不 同 的 设备 分 成 了 四 大 类 别 : small、normal、large 及 xlarge。 
表 17-1 展 示 了 每 个 类 别 修饰 符 的 最 低 屏幕 大 小 。 
表 17-1 屏幕 大 小 修饰 符 









































名 称 最 低 屏幕 大 小 名 称 最 低 屏幕 大 小 
small 320X426dp large 480X 640dp 
normal 320X470dp xlarge 720X960dp 


顺应 允许 开发 者 测试 设备 尺寸 的 新 修饰 符 的 推出 ， 屏 幕 大 小 修饰 符 已 在 Android 3.2 中 弃 用 。 


表 17-2 列 出 了 新 引入 的 修饰 符 。 





表 17-2 独立 的 屏幕 尺寸 修饰 符 
修饰 符 格 式 描 述 
wXXXdp 有 效 宽度 : 宽度 大 于 或 等 于 XXX dp 
hXXXdp 有 效 高 








浸 
伍 
洒 

















大 于 或 等 于 XXX dp 
度 或 高 度 ( 两 者 中 最 小 的 那个 ) 大 于 或 等 于 XXX dp 


河 
到 
河 

















六 
河 


swXXXdp 最 小 宽度 
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假设 想 指定 某 个 布局 仅 适 用 于 屏幕 宽度 至 少 为 300dp 的 设备 ， 可 以 使 用 宽度 修饰 符 ， 并 将 布 
局 文件 放 和 reslayout-w300dp 目 录 下 (ww 代表 屏幕 宽度 )。 类 似 地 ， 我 们 也 可 以 使 用 “hXXXdp” 
修饰 符 〈h 代 表 屏 幕 高 度 )。 

设备 方向 变换 的 话 , 设备 的 宽 和 高 也 会 交换 。 为 了 确定 某 个 具体 的 屏幕 尺寸 , 我 们 可 以 使 用 
sw (最 小 宽度 )。sw 指 定 了 屏幕 的 最 小 规格 尺寸 。 设 备 的 方向 会 变 ， 因 此 sw 可 以 是 最 小 宽度 ， 也 
可 以 是 最 小 高 度 。 例 如 ， 如 果 屏 幕 尺寸 为 1024x800 ， 那 么 sw 值 就 是 800; 而 如 果 屏 幕 尺 寸 为 
800x1024， 那 么 sw 值 仍 然 是 800。 


17.4 ”挑战 练习 : 添加 滑动 删除 功能 


为 了 改善 用 户 体验 , 请 为 CriminalIntent 应 用 的 RecyctlerView 添 加 滑动 删除 功能 。 也 就 是 说 ， 
用 户 向 右 滑动 一 下 ， 就 能 删除 一 条 crime 记 录 。 

为 了 实现 这 个 功能 ， 你 需要 使 用 ItemTouchHeLper 类 ( developer.android.com/reference/ 
android/support/v7/widget/helper/ItemTouchHelper.html )。 这 个 类 提供 了 滑动 删除 实现 ， 包 含 在 
RecyclerView 支 持 库 中 。 
















































































应 用 本 地 化 








CriminalIntent 应 用 预计 会 很 火 ， 为 了 方便 更 多 的 用 户 使 用 ， 我 们 决定 首先 实施 中 文本 地 化 。 

本 地 化 是 一 个 基于 设备 语言 设置 ， 为 应 用 提供 合适 资源 的 过 程 。 本 章 为 CriminalIntent 应 用 提 
供 中文 版 字符 串 资 源 。 设 备 语言 如 果 设 置 为 中 文 ，Android 就 会 自动 找到 并 使 用 相应 的 中 文 资源 ， 
如 图 18-1 所 示 。 














€ Criminalintent 





krime 简 短 描述 





| 





[oj 
明细 


THU MAR 16 10:37:13 GMT+08:00 2017 





中 是 否 解决 
嫌疑 人 联系 方式 


抗议 或 投诉 


图 18-1 ”中 文 版 CriminalIntent 应 用 


18.1 资源 本 地 化 


语言 设置 是 设备 配置 的 一 部 分 ( 详 见 第 3 章 的 “设备 配置 与 备 选 资源 ”小 节 )。 和 处 理 屏 幕 方 
向 、 屏 幕 尺 寸 以 及 其 他 配置 因素 改变 一 样 ，Android 也 提供 了 用 于 不 同 语言 的 配置 修饰 符 。 本 地 
化 处 理 因 而 变 得 简单 : 创建 带 目标 语言 配置 修饰 符 的 资源 子 目 录 , 并 放 人 备 选 资源 。 其 余 工 作 就 
交 给 Android 资 源 系统 自动 处 理 。 
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在 项 目 工具 窗口 中 ， 右 键 点 击 res/values 目 录 ， 选 择 New 一 Values resource file 菜 单项 。 文 件 
名 输入 strings.xml，Source set 选 main，Directory name 设 置 为 values。 然 后 ， 在 Available qualifiers 
列表 窗口 ， 选 中 Locale, 使 用 >> 按 钮 把 它 移入 Chosen qualifiers 窗 口 ， 在 Language 列 表 窗 口中 选 zh: 
Chinese， 此 时 ， 右 边 的 Specific Region Only 窗 口 会 自动 选中 Any Region， 这 就 是 我 们 想 要 的 ， 所 
以 无 需 更 改 。 





File name: strings.xml 
Source set: main 


Directory name: values-zh 


Available qualifiers: Chosen qualifiers: Language: Specific Region Only: 

@ Country Code @zh 二 uz: Uzbek Any Region 

全 | Network Code 到 ve: Venda 国 cCN: China 

Layout Directior vi: Vietnamese mm SG: Singapore 

区 Smallest Screen vo: Volapiik 

区 Screen Width Ewa: Walloon 

Screen Height 3 Ewo: Wolof 

Size 可 xh: Xhosa 

Ratio es Eyo: Yoruba 

多 Orientation 园 zh: Chinese 

国 Ul Mode 盏 zu: Zulu 

® Night Mode 

了 区 Density 

区 Touch Screen 

加 Keyboard Tip: Type in listto filter Show All Regions 
carce 





图 18-2 ”新 建 资源 文件 


设置 完成 了 。 现 在 ， 新 建 资源 文件 窗口 应 该 类 似 于 网 18-2。 

注意 , Android Studio 会 自动 设置 Directory name 为 values-zh。 语言 配置 修饰 符 来 自 于 ISO 639-1 
标准 代码 ， 每 个 修饰 符 都 由 两 个 字符 组 成 。 中 文 的 修饰 符 为 -zh。 

点 击 OK 按钮 完成 。 带 (zh 后 组 的 新 strings.xml 文 件 会 在 res/values 下 列 出 。 现 在 观察 一 下 , 在 
项 目 工具 窗口 ，strings 资 源 文件 都 是 按 组 归 类 的 ， 如 图 18-3 所 示 。 








局 Android 全 站 | 将 - 4+ 
v Dapp 
p> Dmanifests 
> Djava 
v= | 
Pp [Olayout 
Pp menu 
pb [mipmap 
Y 加 values 
Pp 后 dimens.xml (2) 
Pp [refs.xml (2) 
了 strings.xml (2) 
加 strings.xml 
strings.xml (zh) 
欧 styles.xml 





图 18-3 ”新 的 strings.xml 文 件 
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然而 ,如 果 查 看 目录 结构 ,你 会 看 到 项 目 现在 有 了 男 一 个 values 目 录 : 





的 strings.xml 就 放 在 这 个 目录 里 ， 如 网 18-4 所 示 。 


国 Project 田 幸 | 类 "及 
v 世 Criminallntent ~/Downloads/AndroidProgram 
白 .gradle 
让 .idea 
加 app 
户 build 
总 src 
站 androidTest 
户 main 
口 java 
res 
辐 drawable-hdpi 
加 drawable-mdpi 
加 drawable-xhdpi 
加 drawable-xxhdpi 
加 drawable-xxxhdpi 
加 layout 
加 menu 
加 mipmap-hdpi 
名 mipmap-mdpi 
加 mipmap-xhdpi 
加 mipmap-xxhdpi 
加 mipmap-xxxhdpi 
加 values 
本 values-sw600dp 
加 values-w820dp 
加 values-zh 
国 strings.xml 
加 xml 


在 Project 视 图 中 查看 新 的 strings.xml 文 件 














图 18-4 


T 











res/values-zh。 新 产生 


现在 , 开始 真正 的 中 文 定制 。 添 加 中 文字 符 串 资源 给 res/values-zh/strings.xml 文 件 ， 如 代码 清 





单 18-1 所 示 。 
代码 清单 18-1 


<resources> 
<string name="app_name">CriminalIntent</string> 
<string name="crime_title_hint">crime 简 短 描述 </string> 
<string name="crime_title_label"> 标 题 </string> 
<string name="crime_details_label"> 明 细 </string> 
<string name="crime_solved_label"> 是 否 解 决 </string> 
<string name="date_picker_title">crime 发 生日 期 </string> 
<string name="new_crime"> 新 增 Crime 记 录 </string> 
<string name="show_subtitle"> 显 示 子 标题 </string> 
<string name="hide_subtitle"> 隐 藏 子 标 题 </string> 
<string name="subtitle format">%1$s crimes</string> 


添加 中 文 备 选 字 符 串 资源 ( res/values-zh/strings.xml ) 
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<string name="crime_suspect_text'"> 嫌 疑 人 联系 方式 </String> 
<string name="crime_report_text"> 抗 议 或 投诉 </string> 
<string name="crime_report">%1$s!crime 发 生 于 %2$s. %3$s, y %4$s</string> 
<string name="crime_report_solved"> 问 题 已 解决 </string> 
<string name="crime_report_unsolved"> 问 题 未 解决 </string> 
<string name="crime_report_no_suspect"> 没 找到 嫌疑 人 </string> 
<string name="crime_report_suspect"> 嫌 疑 人 是 %s</string> 
<string name="crime_report_subject">crime 处 理 情况 报告 </string> 
<string name="send_report"> 投 诉 方式 </string> 
</resources> 


这 样 便 完成 了 为 应 用 提供 本 地 化 资源 的 任务 。 要 验证 成 果 ， 请 打开 Settings ， 找 到 语言 设置 
选项 ( Android 版 本 繁多 , 但 语言 设置 选项 一 般 被 标 为 Language and input、Language and Keyboard 
或 其 他 类 似 名 称 )， 将 设备 语言 改 为 简体 中 文 。 

运行 CriminalIntent 应 用 。 真 好 ， 末 切 又 熟悉 的 中 文 界面 出 现 了 。 

















18.1.1 默认 资源 


英文 语言 的 配置 修饰 符 为 -en。 处 理 完 中 文本 地 化 ,你 自然 想到 也 把 原来 的 values 目 录 重 命名 
为 values-en。 这 可 不 是 个 好 主意 。 现 在 假设 你 已 经 这 么 做 了 : 应 用 现在 有 一 个 英文 版 values-en/ 
strings.xml 和 一 个 中 文 版 values-zh/strings.xml。 

运行 应 用 ,一切 都 很 正常 , 语言 改 为 中 文 ， 也 没 问 题 。 但是， 如 果 有 个 用 户 把 设备 语言 改 为 
法 语 , 会 出 现 什么 情况 呢 ?” 问 题 来 了 ，Android 无 法 找到 匹配 当前 语言 设置 的 资源 ! 后 果 很 严重 ， 
有 多 严重 ? 那 要 看 应 用 的 那些 字符 串 资 源 是 在 哪里 引用 的 。 

如 果 不 匹 配 的 字符 串 资源 用 在 XML 布局 文件 中 ， 应 用 会 显示 资源 ID 数值 。 若 想 亲 眼见 识 一 
下 ， 可 在 values/strings.xml 文 件 中 注释 掉 crime titte LabeL 定 义 (如 果 想 快速 注释 一 行 代码 ， 
可 使 用 Command+/ 或 CtrlH/ 快 捷 键 )。 


代码 清单 18-2 ”注释 掉 crime title Label 定义 (res/values/strings.xml ) 


<resources> 
<string name="app_ name">CriminalIntent</string> 
<string name="crime title hint">Enter a title for the crime.</string> 
<!--<string name="crime title label">Title</string>--> 






















































































(fragment crime.xml3| 用 了 crime title label ) 


<TextView 
style="?android:listSeparatorTextViewStyle" 
android:layout width="match parent" 
android:layout height="wrap _ content" 
android:text="@string/crime title label" /> 


在 语言 设置 为 英语 的 设备 上 运行 应 用 。 如 图 18-5 所 示 ， 应 用 显示 的 不 是 标题 文字 ， 而 是 
crime title Labet 的 资源 ID。 
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WA 7:00 


€ Criminalintent 





@2131165217 


Enter a title for the crime. 
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Solved 








CHOOSE SUSPECT 


SEND CRIME REPORT 


图 18-5 ”布局 找 不 到 默认 资源 定义 ， 转 而 使 用 资源 ID 


更 糟 的 是 ， 如 果 不 匹 配 的 字符 串 资源 用 在 Java 代 码 中 ， 应 用 就 会 月 溃 。 在 values/strings.xml 
文件 中 注释 掉 crime_report subject 定 义 ， 亲 眼见 证 一 下 。 


























代码 清单 18-3 ”注释 掉 crime report subject 定义 (res/values/strings.xml ) 


<string name="crime report no suspect">there is no suspect.</string> 
<string name="crime report suspect">the suspect is %s.</string> 
<!--<string name="crime report subject">CriminalIntent Crime Report</string>--> 

















(在 CrimeFragment.java 文 件 中 ，crime report subject 是 在 crime report 按 钮 监听 需 代 码 中 
引用 的 。) 


mReportButton.setOnClicklistener(new View.OnClicklistener() { 

public void onClick(View v) { 
Intent i = new Intent(Intent.ACTION SEND); 
i.setType("text/plain"); 
i.putExtra(Intent.EXTRA TEXT, getCrimeReport()); 
i.putExtra(Intent.EXTRA SUBJECT, 

getString(R.string.crime report subject)); 

i = Intent.createChooser(i, getString(R.string.send report)); 
startActivity(i); 

} 

}); 


运行 应 用 ， 点 SEND CRIME REPORT 按 钮 。 如 图 18-6 所 示 ， 应 用 骨 沉 了。 
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Criminallntent has stopped 


C Open app again 


全 Mute until device restarts 

















图 18-6_ Java 代码 找 不 到 资源 定义 ， 应 用 骨 溃 


总 结 一 下 : 提供 默认 资源 非常 重要 。 没 有 配置 修饰 符 的 资源 就 是 Android 的 默认 资源 。 如 果 
无 法 找到 匹配 当前 配置 的 资源 ，Android 就 会 使 用 默认 资源 。 默 认 资 源 至 少 能 保证 应 用 正常 运行 。 

( 暂时 保留 crime_report subject 和 crime title LabeltL 的 定义 注释 ， 稍 后 会 用 到 。) 

例外 的 屏幕 显示 密度 

Android 默 认 资源 使 用 规则 并 不 适用 于 屏幕 显示 密度 。 项 目的 drawable 目 录 通 常 按 屏幕 显示 密 
度 要 求 ， 带 有 -mdpi、-xxhdpi 这 样 的 修饰 符 。 不 过 ，Android 决 定 使 用 哪 一 类 drawable 资 源 并 不 是 
简单 地 匹配 设备 的 屏幕 显示 密度 ， 也 不 是 在 没有 匹配 的 资源 时 直接 使 用 默认 资源 。 

最 终 的 选择 取决 于 对 屏幕 尺寸 和 显示 密度 的 综合 考虑 。Android 甚 至 可 能 会 选择 低 于 或 高 于 
当前 设备 屏幕 密度 的 drawable 资 源 ， 然 后 通过 缩放 去 适 配 设备 。 访 问 网 页 developerandroid. 
com/guide/practices/screens_support.html， 了 解 更 多 相关 信息 。 无 论 如 何 ， 请 记 住 一 点 : 不 要 在 
res/drawable/ 目 录 下 放置 默认 的 drawable 资 源 。 


18.1.2 ”检查 资源 本 地 化 完成 情况 


是 否 已 为 某 种 语言 提供 全 部 本 地 化 资源 ? 应 用 支持 的 语言 越 来 越 多 ， 想 快速 确认 也 越 来 越 
难 。Google 早 已 想到 这 点 , 所 以 Android Studio 提 供 了 资源 翻译 编辑 器 这 个 工具 。 这 个 便利 工具 能 
集中 化 查看 资源 翻译 完成 情况 。 在 项 目 工具 窗口 , 右键 点 击 某 个 语言 版 本 的 strings.xml, 选择 Open 
Translations Editor 菜 单项 打开 资源 翻译 编辑 器 。 如 图 18-7 所 示 ， 资 源 翻 译 编辑 器 随即 显示 了 对 应 
语言 的 全 部 资源 定义 。crime_report_subject 和 crime_title_label 的 定义 已 注释 , 所 以 它们 
被 标 红 了 。 
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+® 


Key 
app_name 


一 Show only keys needing translations 


| Default Value 
Criminallntent 


crime_details_label Details 


crime_report 


%1$slL...] 


crime_report_no_susp' there is no suspect. 


crime_report_sol 


lved The caseis solved 


crime_report_subject 


crime_report_suspect the suspect is %s. 


crime_report_text 


Send Crime Report 


crime_report_unsolvec The case is not solved 


crime_solved_label 
crime_suspect_text 


crime_title_hint 
crime_title_label 
date_picker title 
hide_subtitle 
new_crime 
send_report 
show_subtitle 
Subtitle_format 


Solved 
Choose Suspect 
Enter a title for the crime. 


Dare of crime: 

Hide Subtitle 

New Crime 

Send crime report via 
Show Subtitle 

%1$d crimes 


| Untra... 
~ Criminalintent 
”明细 
%15sI[...] 
” ” 没 找 到 群 疑 人 
一 问题 已 解决 


嫌疑 人 是 %s 
问题 未 解决 

是 否 解决 
嫌疑 人 联系 方式 
crime 简 短 描述 


crime 发 生日 期 
隐藏 子 标题 

新 增 crime 记 录 
发 送 方式 
显示 子 标题 
%1$d crimes 


Chinese (zh) 


Order atranslation 














图 18-7 检查 应 用 本 地 化 完成 情况 


(现在 可 以 取消 注释 crime_report subject 和 crime title label 的 定义 了 ， 别 忘 了 用 快 
捷 键 。) 














18.1.3 ”区 域 修饰 符 


修饰 资源 目录 也 可 以 使 用 语言 加 区 域 修饰 符 ， 这样 可 以 让 资源 使 用 更 有 针对 性 。 例如, 西 班 
牙 语 可 以 使 用 -es-rES 修 饰 符 。 其 中 ，r 代 表 区 域 ，ES 是 西班牙 语 的 ISO 3166-1-alpha-2 标 准 码 。 配 
置 修饰 符 对 大 小 写 不 敏感 。 但 最 好 遵守 Android 命 名 约定 : 语言 代码 小 写 ， 区 域 代码 大 写 , 但 前 
面 加 个 小 写 的 r。 

注意 , 语言 区 域 修饰 符 ， 如 -es-rES， 看 上 去 像 两 个 不 同 的 修饰 符 的 合体 ， 实 际 不 是 这 样 。 这 
是 因为 ， 区 域 本 身 不 能 单独 用 作 修 饰 符 。 

图 18-8 展 示 了 Android 不 同系 统 版 本 的 区 域 资源 匹配 策略 。 





























获取 用 户 


locale 信 息 



























从 用 户 localg 
和 否 中 去 掉 区 域 广 


信息 













Android 7.0 


抱 域 不 匹配 ， 
以 下 版 本 ? 语言 匹 本 


资源 精准 
日 语言 匹配 ? 


匹配 ? 


仅 匹 配 语言 
资源 ? 




















































| | | | 
使 用 精准 使 用 语言 使 用 加 ie 
情 ; 用 三 使 用 资源 (语言 匹配 ,但 
匹配 资源 匹配 资源 认 资 源 区 域 不 匹配 ) 












































图 18-8 ”区 域 资源 匹配 策略 ( Nougat 及 其 之 前 的 系统 版 本 ) 


如 果 一 个 资源 修饰 符 同 时 包含 locale 和 区 域 ， 那么 它 有 两 次 机 会 匹配 用 户 的 locale。 首 先 ， 如 
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果 语 言 和 区 域 修饰 同时 匹配 用 户 的 locale， 那 这 就 是 一 次 精准 匹配 。 如 果 是 非 精 准 匹 配 ， 系 统 会 
去 除 区 域 修饰 ， 然 后 仅 以 语言 去 做 精准 匹配 。 

在 运行 Nougat 之 前 的 系统 版 本 的 设备 上 ， 如 果 找 不 到 匹配 的 资源 , 应 用 就 会 使 用 无 任何 修饰 
符 的 默认 资源 。Nougat 系 统 已 优化 locale 支 持 ， 支 持 更 多 locale 以 及 支持 同一 设备 选择 多 个 locale。 
因此 , 为 了 让 应 用 显示 更 准确 的 语言 ， 系统 使 用 了 更 智能 化 的 资源 匹配 策略 。 如 果 找 不 到 精准 匹 
配 ， 也 找 不 到 仅 针 对 语言 的 匹配 ， 系 统 就 会 去 匹配 有 同样 语言 而 区 域 不 同 的 资源 。 

来 看 个 例子 。 假 设 设备 语言 设置 为 西班牙 语 ， 区 域 设置 为 智利 ， 如 图 18-9 所 示 。 应 用 准备 了 
西班牙 版 本 和 墅 西 哥 版 本 的 资源 ( values-es-rES 和 values-es-rMX )， 以 及 默认 的 strings.xml 资 源 。 
如 果 是 Nougat 之 前 的 系统 版 本 ， 应 用 会 使 用 默认 资源 。 如 果 是 Nougat 系 统 ， 应 用 会 使 用 
values-es-TMX/strings.xml 资 源 。 怎 么 样 ， 智 能 多 了 吧 ! 

































































设备 locale 为 -es-rCL 
(西班牙 语 ， 智 利 版 本 ) 








WhatsForDinner 应 用 的 资源 : 
strings.xml 文 件 














values (默认 ) 8 


<string name="app_name">Menu</string> [MAN COURSE Shrimp 前 的 系统 
<string name="main_course">Main course</string> | 
<string name="prawns">Shrimp</string> 


Nougat 之 


vatues-es-rES (西班牙 语 ， 西 班 牙 版 本 ) : 


<string name="app_name">Menti</string> 
<string name="main_course">Plato principal</string> 
<string name="prawns">Gambas</string> 














values-es-rMX (西班牙 语 ， 墨 西 哥 版 本 ) : 


<string name="app_name">Menti</string> 人 PLATO FUERTE Camarones 
<string name='"main_course">PLato fuerte</string> Nougat 
<string name="prawns">Camarones</string> 
































图 18-9 区域 匹 配 实例 ( Nougat 及 其 之 前 的 系统 版 本 ) 


以 上 例子 有 策划 之 嫌 。 但 无 论 如 何 ,可 从 中 得 出 一 个 重要 结论 : 资源 应 尽 可 能 通用 ,最 好 是 
使 用 仅 限 语言 的 修饰 目录 , 尽量 少 用 区 域 修饰 。 就 上 例 来 说 , 与 其 维护 三 类 不 同 区 域 西班牙 语 的 
资源 ， 不 如 只 提供 values-es 版 资源 。 这 样 ， 不 仅 方便 开发 维护 ， 也 方便 适 配 不 同 版 本 的 系统 。 

测试 定制 区 域 

不 同 设备 不 同 版 本 的 Android 会 支持 不 同 的 区 域 。 有 时 ， 你 也 可 能 提供 针对 某 个 特定 区 域 的 
资源 , 但 测试 时 发 现 测试 设备 无 此 区 域 。 碰 到 这 事 ,不 用 担心 ,你 可 以 使 用 模拟 右上 的 定制 区 域 
工具 。 用 这 个 工具 ,可 以 定制 出 系统 镜像 没有 的 区 域 。 模 拟 器 运行 时 ， 会 模拟 出 一 个 包含 语言 
区 域 的 运行 时 配置 。 这 样 ， 你 就 可 以 测试 应 用 表现 如 何 了 。 

模拟 需 已 内 置 定制 区 域 工具 。 运行 模拟 需 , 打开 应 用 启动 屏 , 点 击 定制 区 域 应 用 图 标 局 动 它 。 
启动 之 后 ， 这 个 工具 会 列 出 系统 现 有 的 区 域 ， 并 允许 你 添加 新 区 域 进行 测试 ， 如 图 18-10 所 示 。 

注意 ,如 果 定 制 了 模拟 器 本 身 不 支持 的 区 域 ， 系 统 界面 仍然 会 使 用 默认 语言 。 测 试 应 用 会 使 
用 所 选 定制 区 域 匹 配 资源 。 
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Custom Locale 


en_US - English (United States) 


ar-Arabic 


ar-EG - ar-eg 


arIL- ar-il 


bg - Bulgarian 


bg-BG - bg-bg 


ca- Catalan 


Ca-ES - ca-es 


cs - Czech 


CSs-CZ - cs-CZ 


OO OO ON OO 


da - Danish 


ADD NEW... 


18.2 配置 修饰 符 


目前 为 止 , 我 们 已 见 过 好 几 个 配置 修饰 符 , 它们 都 用 于 提供 可 选 资 源 ， 如 语言 (values-zh/ )、 





























图 18-10 定制 区 域 工具 











屏幕 方位 (layout-land/ )、 屏 幕 显 示 密 度 ( drawable-mdpi/ ) 以 及 屏幕 尺寸 ( layout-sw600dp/ )。 


表 18-1 列 出 了 一 些 设备 配置 特征 。 针 对 它们 ，Android 提 供 配置 修饰 符 以 更 好 地 匹配 资源 。 
可 带 配 置 修饰 符 的 设备 配置 特征 


Po ~ ow WD- 











表 18-1 





移动 国家 码 ， 通 常 附 有 移动 网 络 码 
语言 代码 ， 通 常 附 有 区 域 代码 
局 方向 


小 宽度 





























用 宽度 


Ee 


J 用 高 度 
屏幕 尺寸 

屏幕 纵横 比 

列 形 屏幕 (API 23+) 
屏幕 方位 

UI 模式 

夜间 模式 

屏幕 显示 密度 
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( 续 ) 
14 触摸 屏 类 型 
15 键盘 可 用 性 
16 首选 输入 法 
17 导航 键 可 用 性 
18 非 文 本 导航 方法 
19 API 级 别 


可 访问 网 页 developer.android.com/guide/topics/resources/providing-resources.html#Alternative- 
Resources， 查 看 表 中 所 有 设备 配置 特征 描述 及 其 对 应 配置 修饰 符 的 使 用 例子 。 

旧 系 统 版 本 Android 并 非 支 持 所 有 配置 修饰 符 。 系 统 知 道 这 一 点 , 所 以 会 给 Android 1.0 之 后 出 
现 的 修饰 符 加 上 平台 版 本 修饰 。 例 如 ， 圆 形 屏幕 修饰 符 自 API 23 级 别 引 入 ， 如 果 你 使 用 它 ， 系 统 
会 自动 加 上 v23。 因 此 ， 如 果 为 新 设备 引入 资源 修饰 符 ， 根 本 不 用 担心 在 旧 系 统 会 遇 到 问题 。 


18.2.1 可 用 资源 优先 级 排 定 


考虑 到 有 那么 多 匹配 资源 的 配置 修饰 符 , 有 时 , 会 出 现 设备 配置 与 好 几 个 可 选 资 源 都 匹配 的 
情况 。 遇 到 这 种 状况 ，Android 会 基于 表 18-1 的 顺序 确定 修饰 符 的 使 用 优先 级 。 

为 了 实际 了 解 这 种 优先 级 排 定 ， 我 们 为 CriminalIntent 应 用 再 添加 一 种 可 选 资源 : 更 详细 的 
crime tittLe_hint 字 符 串 资源 ( 针对 屏幕 宽度 至 少 600dp 的 设备 )。crime_titte_hint 资 源 显 示 
在 crime 的 可 编辑 标题 框 里 (用户 输 入 标题 前 )。 应 用 运行 在 平板 或 者 处 于 水 平 模式 的 设备 上 时 ( 屏 
宽 至 少 600dp )， 标 题 框 才 会 显示 更 详细 的 内 容 ， 提 示 用 户 输入 crime 标 题 。 

新 建 一 个 字符 串 资 源 文 件 ， 并 将 其 放 人 values-w600dp 目 录 。( -w600dp 会 匹配 屏幕 宽度 大 于 
600dp 的 任何 设备 。 如 果 设 备 水 平 模式 的 屏幕 符合 条 件 也 可 以 。) 如 何 添加 新 资源 文件 可 参考 18.1 
节 。 设 置 完成 后 的 界面 大 致 如 网 18-11 所 示 。 


® © New Resource File 



















































































File name: strings.xml 

Source set: main [3 
Directory name: |values-w600dp 

Available qualifiers: Chosen qualifiers: ran lh 
@@ Country Code ET 600 

@: Network Code 

因 Locale 

加 Layout Direction 

加 Smallest Screen Wid >> 

Screen Height | 

园 Size 

四 Ratio 

局 Orientation 

辐 Ul Mode 

图 Night Mode 

矶 nensitv 





图 18-11 为 大 屏 添加 字符 串 资 源 








打开 values-w600dp/strings.xml 文 件 ， 参 照 代码 清单 18-4， 为 crime_title_hint 添 加 更 详细 
0 文字 18 
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代码 清单 18-4 ”针对 宽屏 的 字符 串 资 源 ( values-w600dp/strings.xml ) 


<resources> 
<string name="crime title hint"> 
Enter a meaningful, memorable title for the crime. 
</string> 
</resources> 


在 宽屏 上 ， 我 们 只 希望 看 到 crime titte_hint 字 符 串 有 不 同 的 描述 ， 所 以 添加 这 一 个 就 可 
以 了 。 字 符 串 备 选 资源 ( 也 包括 其 他 values 资 源 ) 都 是 基于 每 一 个 字符 串 提 供 ， 因 此 ， 字 符 串 资 
源 相 同时 ， 无 需 再 复制 一 份 。 重 复 的 字符 串 资源 只 会 导致 未 来 的 维护 亚 梦 。 

现在 总 共有 三 个 版 本 的 crime _titte_hint 资 源 : values/strings.xml 文 件 中 的 默认 版 本 、 
values-zh/strings.xml 文 件 中 的 中 文 备 选 版 本 以 及 values-w600dp/strings.xml 文 件 中 的 宽屏 设备 备 选 
版 本 。 

在 设备 语言 设置 为 简体 中 文 的 前 提 下 ， 运 行 CriminalImtent 应 用 ， 然 后 旋转 设备 至 水 平 模式 。 
为 中 文 备 选 版 本 的 资源 优先 级 最 高 ， 所 以 我 们 看 到 的 是 来 自 于 values-zh/strings.xml 文 件 的 字符 
串 资源 ， 如 图 18-12 所 示 。 
































THU MAR 16 10:37:13 GMT+08:00 2017 


口 是 否 解决 

















图 18-12 ” Android 排 定语 言 优先 级 高 于 屏幕 方位 


也 可 以 将 设备 的 语言 重新 设置 为 英语 , 然后 再 次 运行 应 用 , 确认 宽屏 模式 的 字符 串 资 源 能 如 
期 出 现 。 


18.2.2 ”多重 配置 修饰 符 


可 以 在 同一 资源 目录 上 使 用 多 个 配置 修饰 符 。 这 需要 各 配置 修饰 符 按 照 优 先 级 别 顺 序 排列 。 
因此 ，values-zh-land 是 一 个 有 效 的 资源 目录 名 ， 而 values-land-zh 目 录 名 则 无 效 。( 在 新 建 资源 文 
件 对 话 框 中 ， 工 具 会 自动 配置 正确 的 目录 名 。) 

为 CriminalIntent 应 用 准备 宽屏 模式 的 中 文字 符 串 资源 。 创 建 的 资源 目录 名 应 为 values-zh- 
w600dp。 参 照 代 码 清 单 18-5， 打 开 values-zh-w600dp/strings.xml 文 件 ， 为 crime title hint 添 加 
中 文字 符 串 资源 。 
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代码 清单 18-5 ”创建 宽屏 中 文 版 字符 串 资源 ( values-zh-w600dp/strings.xml ) 


<resources> 
<string name="crime _ title hint"> 
请 输入 简短 、 好 记 的 Crime 描 述 
</string> 
</resources> 
在 设备 语言 已 设置 为 简体 中 文 的 前 提 下 ， 运 行 CriminalIntent 应 用 ， 确 认 新 的 备 选 资 源 如 期 出 
现 ， 如 图 18-13 所 示 。 


[2 











Criminalintent 


请 输入 简短 、 好 记 的 crime 描 述 





THU MAR 16 10:31:11 GMT+08:00 2017 


口 是 否 解决 





图 18-13 ”宽屏 模式 下 的 中 文字 符 串 资源 出 现 了 








18.2.3 ”寻找 最 匹配 的 资源 


我 们 来 看 看 Android 是 如 何 确定 crime_titte_hint 资 源 版 本 的 。 首 先 ,当前 设备 有 以 下 四 个 
版 本 的 字符 串 备 选 资源 : 


口 values/strings.xml 








口 values-zh/strings.xml 

口 values-w600dp/strings.xml 

口 values-zh-w600dp/strings.xml 

其 次 ,在 设备 配置 方面 , 有 台 Nexus 5X, 语言 设 为 简体 中 文 , 屏 宽 600dp 以 上 ( 可 用 宽度 731dp， 
可 用 高 度 411dp )。 

1. 排除 不 兼容 的 目录 

要 找到 最 匹配 的 资源 ，Android 首 先 排除 不 兼容 当前 设备 配置 的 资源 目录 。 

结合 备 选 资源 和 设备 配置 来 看 ， 四 个 版 本 的 备 选 资源 均 兼 容 设 备 的 当前 配置 。( 如 果 设 备 旋 
转 至 竖 直 模式 ， 设 备 配 置 会 改变 。 此 时 ,values-w600dp/ 与 values-zh-w600dp/ 资 源 目 录 不 兼容 当前 
配置 ， 因 此 排除 。) 

2. 按 优先 级 表 排除 不 兼容 的 目录 

筛 掉 不 兼容 的 资源 目录 后 ， 自 优先 级 最 高 的 MCC ( 移动 国家 码 ) 开始 ，Android 逐 项 查看 并 
按 优先 级 表 继 续 盘查 不 兼容 目录 (〈 表 18-1 )。 如 果 有 任何 以 MCC 为 修饰 符 的 资源 目录 ， 那 么 所 有 
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带 MCC 修 饰 符 的 都 会 被 排除 。 如 果 仍 有 多 个 目录 匹配 ，Android 就 继续 按 次 高 优先 级 筛选 ， 如 
此 反复 ， 直 至 找到 唯一 满足 兼容 性 的 目录 。 

本 例 中 没有 目录 包含 MCC 修 饰 符 ， 因 此 无 法 筛选 掉 任 何 目录 。 接 着 ，Android 查 看 到 次 高 优 
先 级 的 设备 语言 修饰 符 。values-zh/ 和 values-zh-w600dp/ 目 录 包 含 语 言 修 饰 符 。 所 以 ， 不 包含 语言 
修饰 符 的 values-w600dp/ 可 排除 。 

于 仍 有 多 个 目录 匹配 ， 因 此 继续 看 优先 级 表 ， 接 下 来 是 屏幕 宽度 。 此 时 ，Android 会 找到 一 
个 带 屏 宽 修饰 符 的 目录 以 及 两 个 不 带 屏 宽 修 饰 符 的 目录 ， 由 此 ，values/ 和 values-zh/ 目 录 也 被 排除 。 
就 这 样 ，values-zh-w600dp/ 成 了 唯一 满足 兼容 需求 的 目录 。 因 而 ，Android 最 终 确定 使 用 
values-zh-w600dp/ 目 录 下 的 资源 。 


18.3 测试 备 选 资源 
开发 应 用 时 ， 为 了 查看 布局 以 及 其 他 资源 的 使 用 效果 ， 一 定 要 针对 不 同 设 备 配置 做 好 测试 。 
在 虚拟 设备 或 实体 设备 上 测试 都 行 ， 还 可 以 使 用 图 形 布局 工具 测试 。 
图 形 布局 工具 有 很 多 选项 ， 用 以 预览 布局 在 不 同 配置 下 的 显示 效果 。 这 些 选 项 有 屏幕 尺寸 、 
设备 类 型 、API 级 别 以 及 设备 语言 等 。 
要 查看 这 些 选 项 ， 可 在 图 形 布局 工具 中 打开 人 fragment crime.xml 文 件 ， 试 用 如 图 18-14 所 示 的 
工具 栏 上 的 一 些 选 项 设置 。 


四 IH. DNexus4. 24- AppTheme @language. O- 
图 18-14 ”使 用 图 形 布局 工具 预览 资源 


如 果 想 确认 项 目 是 否 包 括 所 有 必需 的 默认 资源 ， 可 设置 设备 使 用 未 提供 本 地 化 资源 的 语言 。 
运行 应 用 ， 查 看 所 有 视图 界面 并 旋转 设备 。 如 果 应 用 崩 演 ， 请 查看 LogCat 中 的 “Resource not 
found...” 错 误 信 息 ， 排 查 缺 少 哪些 默认 资源 。 也 请 关注 是 否 存 在 非 骨 演 型 问题 ， 如 前 面 提 到 的 用 
户 界面 显示 资源 ID 那样 的 问题 。 
恭喜 ! CriminalIntent 应 用 支持 中 英文 了 。 有 了 原生 用 户 界 面 ， 应 用 用 起 来 更 高 效 。 怎 么 样 ， 
让 应 用 支持 新 语言 很 简单 吧 ! 也 就 是 添加 带 修饰 符 的 额外 资源 文件 而 已 ! 


18.4 ”挑战 练习 : 日 期 本 地 化 


你 可 能 已 经 注意 到 了 ,不管 设备 locale 怎 么 调整 ，CriminalImmtent 应 用 的 日 期 依然 是 美国 格式 。 
请 按照 设备 locale 设 置 ， 进 一 步 本 地 化 ， 让 日 期 以 中 文 年 月 日 显示 。 这 个 练习 应 该 难 不 倒 你 。 
查阅 开发 者 文档 有 关 DateFormat 类 的 用 法 和 指导 。DateFormat 类 有 个 日 期 格式 化 工具 , 文 
持 按 locale 做 日 期 格式 化 。 使 用 该 类 内 置 的 配置 常量 ， 还 可 以 进一步 定制 日 期 显示 。 
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本 章 ， 我 们 证 CriminalIntent 应 用 更 易 用 。 一 个 易 用 的 应 用 适合 所 有 人 使 用 ， 即 便 是 视力 、 行 
动 、 听 力 有 障碍 的 人 也 能 使 用 。 这 些 障碍 有 永久 性 的 ,也 有 暂时 性 的 或 特定 场景 下 的 : 刚 经 过 眼 
科 检 查 后 ,瞳孔 放大 ,有 眼睛 会 看 不 清楚 ; 做 饭 油 平平 的 手 难以 触 碰 屏 幕 ; 音乐 厅 里 的 音乐 声 盖 过 
了 手机 的 一 切 声音 ， 等 等 。 总 之 ， 应 用 越 易 用 ， 用 户 用 起 来 就 越 开 心 。 

开发 适合 所 有 人 的 易 用 应 用 非常 困难 , 但 不 能 因为 困难 就 退缩 。 本 章 ， 利 用 学 习 开 发 或 设计 
易 用 应 用 的 突破 口 , 我们 先 迈 出 一 小 步 , 让 有 视力 障碍 的 用 户 也 能 方便 地 使 用 CriminalIntent 应 用 。 

本 章 不 会 修改 用 户 界面 。 我 们 会 使 用 一 个 叫 TalkBack 的 辅助 工具 ， 让 应 用 更 加 易 用 。 


19.1 TalkBack 


TalkBack 是 Google 开 发 的 Android 屏 幕 阅读 器 。 基 于 用 户 的 操作 ， 它 能 读 出 屏幕 上 的 内 容 。 

TalkBack 实 际 是 一 个 辅助 服务 ,这 个 特别 的 部 件 能 读 取 应 用 屏幕 上 的 信息 ( 无论 哪 种 应 用 都 
可 以 )。 只 要 不 嫌 麻 烦 ， 谁 都 可 以 设计 开发 这 样 的 辅助 服务 。 但 TalkBack 已 经 非常 好 用 ， 其 应 用 
相当 广泛 。 

要 使 用 TalkBack， 首 先 要 有 一 台 Android 设 备 ( 虚拟 设备 不 支持 TalkBack )。 确 保 手 机 没有 静 
音 。 不 过 ， 建 议 先 找 副 耳 机 戴 着 ， 因 为 一 旦 启用 TalkBack， 手 机 就 哄 哄 不 休 地 说 个 没完 。 

要 启用 TalkBack， 请 打开 设置 ,点 按 辅 助 功能 。 在 服务 类 别 下 ,点 按 TalkBack 打 开 它 。 然 后 ， 
点 按 右上 角 开 关 启 用 TalkBack 服 务 ， 如 图 19-1 所 示 。 

如 图 19-2 所 示 ，Android 会 弹出 一 个 对 话 框 , 要 求 用 户 对 诸如 监测 用 户 行为 、 修 改 某 些 设置 这 
样 的 操作 授权 。 点 击 OK 按钮 同意 。 
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拟 “TalkBack ane 


Off 入 





When TalkBack is on, your device provides spoken feedback 
to help blind and low-vision users. For example, it describes 
What you touch, select and activate. 

If you have turned TalkBack on accidentally turn it off by 
tapping the switch untilthe green outline is around it then 
double-tapping it Do the same interaction for the resulting 
confirmation dialog. 


图 19-1 TalkBack 设置 屏 


现在 ，TalkBack 已 处 于 启用 状态 (如 
向 上 按钮 退出 。 




















Use TalkBack? 
TalkBack needs to: 


* Observe your actions 
Receive notifications when you're 
interacting with an app. 


Retrieve window content 
Inspect the content of a window you're 
interacting with 


Turn on Explore by Touch 
Tapped items will be spoken aloud and the 
screen can be explored using gestures 


Turn on enhanced web 
accessibility 

Scripts may be installed to make app 
content more accessible 


Observe text you type 


Includes personal data such as credit card 
numbers and passwords 


CANCEL OK 





图 19-2” 给 TalkBack 授 权 

















果 是 首次 使 用 ， 还 会 看 到 使 用 演示 教程 ) 点 按 工 具 栏 





注意 , 屏幕 上 是 不 是 有 了 变化 ?一 个 绿 框 出 现在 向 上 按钮 上 ， 如 图 19-3 所 示 。 而 且 设 备 开 始 
说 话 :“ 向 上 导航 按钮 ， 连 点 两 下 可 激活 它 。 









向 上 导航 按钮， 
连 点 两 下 可 激 
活 它 。 








图 19-3 TalkBack 








VAM 7:00 


拟 | TalkBack SETTINGS 


on 


When TalkBack is on, your device provides spoken feedback 
to help blind and low-vision users. For example, it describes 
what you touch, select, and activate. 


If you have turned TalkBack on accidentally, turn it off by 
tapping the switch until the green outline is around it then 
double-tapping it. Do the same interaction for the resulting 
confirmation dialog. 








启用 


[1 
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(注意 , 在 移动 设备 屏幕 上 操作 时 ,“ 点 按 ” 是 常见 的 说 法 , 但 TalkBack 却 使 用 “点 ”以 及 “ 连 
点 两 下 "。 这 并 不 常见 。) 

绿 框 表示 当前 UI 元 素 获 得 了 辅助 焦点 。 一 次 只 能 有 一 个 UI 元 素 得 到 辅助 焦点 。UI 元 素 得 到 畏 
助 焦点 后 ，TalkBack 会 提供 该 UI 元 素 的 信息 。 

设备 启用 TalkBack 后 ， 点 操作 会 给 予 UI 元 素 焦点 ， 连 点 两 下 会 激活 。 所 以 ， 当 向 上 按钮 获得 
焦点 后 , 连 点 两 下 就 回 到 上 一 屏 了 。 如 果 是 checkbox 获 得 焦点 , 连 点 两 下 就 是 切换 色 选 状态 。( 同 
样 ， 如 果 设 备 锁 屏 了 ， 点 锁 屏 按钮 ， 然 后 连 点 两 次 屏幕 任何 地 方 就 会 解锁 。) 












































19.1.1 点 击 浏览 


只 要 启用 了 TalkBack， 点 击 浏览 (Explore by Touch ) 功能 也 会 开启 。 这 就 意味 着 ， 点 按 某 
UI 元 素 ， 设备 就 会 读 出 相关 信息 。( 当然 ， 被 点 按 的 UI 元 素 要 有 可 读 信息 才 行 。) 

让 向 上 按钮 仍 处 于 聚焦 状态 ， 连 点 两 次 屏幕 任何 地 方 ，TalkBack 就 会 读 出 : “Accessibility。” 

Android 框 架 里 的 组 件 ， 如 TooLbar 、RecycterView、ListvView 以 及 Button 等 ， 默 认 都 支 
持 TalkBack。 想 要 用 好 TalkBack 辅 助 功能 ， 应 尽 可 能 多 用 框架 内 置 组 件 。 当 然 ， 也 可 以 让 定制 组 
件 支持 TalkBack 辅 助 功能 ， 不 过 ， 这 个 话题 比较 复杂 ， 已 超出 本 书 教学 范畴 。 

需要 两 根 手指 按 住 屏 幕 上 下 滚动 才能 滚动 列表 。 滚 动 时 ,设备 会 发 出 声响 。 这 实际 是 对 滚动 
的 一 种 声音 反馈 。 






































19.1.2 ”线性 浏览 


想象 一 下 ， 你 第 一 次 点 击 浏览 一 个 应 用 会 是 什么 情况 ?很 可 能 你 不 知道 点 击 哪个 按钮 才 对 。 
你 明白 ,要 想 知道 按 了 什么 按钮 , 只 能 等 TalkBack 读 出 聚焦 按钮 说 明 才 行 。 这 会 是 一 种 什么 体验 ? 
结果 很 可 能 是 多 次 按 同一 个 按钮 ， 甚 至 是 完全 摸 不 着 头脑 。 
好 在 TalkBack 还 有 线性 浏览 功能 。 事 实 上 ,使 用 TalkBack 最 常见 的 方式 就 是 使 用 线性 浏览 : 
右 滑 屏幕 ,辅助 焦 点 移动 到 下 一 个 UI 元 素 ; 左 滑 , 移动 到 上 一 个 UI 元 素 。 这 样 ， 用户 就 可 以 线性 
浏览 应 用 ， 再 也 不 用 碰 运 气 了 。 

下 面 一 起 来 体验 一 下 。 启 动 CriminalIntent 广 用， 进入 crime 明 细 界 面 。 点 工具 栏 上 的 标题 栏 ， 
让 其 聚焦 。 设 备 开 始 明 读 “CriminalIntent”， 如 图 19-4 所 示 。 

现在 ， 向 右 滑 屏 。 如 图 19-5 所 示 ， 辅 助 焦点 随即 移动 到 添加 新 crime 记 录 的 按钮 上 。TalkBack 
读 到 :“ 添 加 新 crime， 连 点 两 下 激活 ， 连 点 两 下 并 按 住 是 长 按 。 对 于 菜单 项 和 按钮 这 样 的 框架 
组 件 ，TalkBack 会 默认 读 出 组 件 上 显示 的 文字 。 添 加 新 crime 的 按钮 上 没有 文字 ，TalkBack 会 去 找 
其 他 地 方 。 在 菜单 项 XML 文件 中 , 我 们 指定 过 标题 信息 (title ), 于 是 TalkBack 就 找到 该 信息 读 出 。 
有 时，TalkBack 也 能 告诉 用 户 某 个 组 件 接受 什么 操作 ， 或 这 是 什么 组 件 。 
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BL EA 


Criminallnteni 十 SHOw suBTITLE 





Scooter stolen while going to the restroom 
Sun May 29 15:50:01 EDT 2016 


Paper clip Ponzi scheme 9 
Tue Jun 28 05:36:04 EDT 2016 


Instagram photos at beach on sick day 
Thu Sep 08 10:09:09 EDT 2016 


Fragment fraud 
Wed Nov 30 22:18:27 EST 2016 


Popcorn left unattended, microwave on 
fire 8o 


Fri Dec 09 12:29:33 EST 2016 








图 19-4 ”标题 已 聚焦 











BEA 


添加 新 crime， 连 点 两 
下 激活 ， 连 点 两 下 并 
按 住 是 长 按 。 


Criminallintent 十 | show suBTITLE 










Scooter stolen while going to the restroom 
Sun May 29 15:50:01 EDT 2016 


Paper clip Ponzi scheme fo 
Tue Jun 28 05:36:04 EDT 2016 


Instagram photos at beach on sick day 
Thu Sep 08 10:09:09 EDT 2016 


Fragment fraud 
Wed Nov 30 22:18:27 EST 2016 


Popcorn left unattended, microwave on 
fire oo 


Fri Dec 09 12:29:33 EST 2016 








图 19-5 ”添加 新 crime 的 按钮 已 聚焦 
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继续 右 滑 , TalkBack 给 出 SHOW SUBTITLE 按 钮 的 信息 。 再 右 滑 , 畏 助 焦点 移动 到 第 一 条 crime 
记录 上 。 现 在 向 左 滑 ， 辅 助 焦点 又 移 回 SHOW SUBTITLE 按 钮 。 总 之 ，Android 会 智能 有 序 地 移 
动 辅助 焦点 。 这 就 是 TalkBack 的 线性 浏览 。 





19.2 ”实现 非 文字 型 元 素 可 读 


屏幕 任意 地 方 ， 进 入 crime 明 细 页 面 。 














19.2.1 添加 内 容 描述 





在 crime 明 细 页 面 ， 点 击 聚 焦 拍 照 按钮 ， 如 图 19-6 所 示 。TalkBack 开 腔 了 :“ 按 钮 没 文字 ， 连 
点 两 下 激活 。” 








于 4 和 7:00 
€ Criminalintent 
ET» ~ » 
按钮 没 文字 ， 连 
EB i 
点 两 下 激活 。 a 
Enter a title for the crime. 
[©] 
DETAILS 
FRI DEC 09 12:39:12 EST 2016 
口 soved 


CHOOSE SUSPECT 


SEND CRIME REPORT 





图 19-6 ”拍照 按钮 已 聚焦 





拍照 按钮 无 文字 描述 ， 除 了 告诉 用 户 连 点 两 下 激活 ，TalkBack 没 什么 好 说 的 。 显 然 ， 这 对 于 
视力 有 障碍 的 人 来 说 ， 并 没有 多 大 用 处 。 

没关系 ， 有 办 法 解决 。 我 们 可 以 给 ImageButton 添 加 内 容 描 述 ， 这 样 TalkBack 就 有 内 容 可 读 
了 。 内 容 描 述 是 一 段 针 对 组 件 的 文字 说 明 ， 供 TalkBack 朗 读 。( 借 处 理 拍照 按钮 的 机 会 ， 一 并 给 
ImageView 预 览 照 片 组 件 添 加 内 容 描述 。) 

要 添加 组 件 内 容 描 述 ， 可 以 在 组 件 的 布局 XML 文件 里 ， 添 加 android: contentDescription 
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属性 。 当然, 也 可 以 在 布局 实例 化 代码 里 , 使 用 someView.setContentDescription(someString) 
方法 。 这 两 种 方式 ， 稍 后 都 会 尝试 。 
添加 内 容 描述 时 ,文字 表述 要 简洁 明了 。TalkBack 会 朗读 给 用 户 听 ， 虽 然 他 们 可 以 调 快 朗读 
速度 ， 但 简洁 的 文字 能 节约 用 户 的 时 间 。 像 组 件 是 什么 类 型 这 种 信息 ，TalkBack 会 自动 提供 ， 所 
以 完全 没 必 要 写 在 内 容 描 述 里 。 
参照 代码 清单 19-1， 为 ImageButton 和 ImageView 添 加 内 容 描 述 


代码 清单 19-1 添加 内 容 描述 字符 串 (res/values/strings.xml ) 


<resources> 












































<string name="crime details label">Details</string> 
<string name="crime solved label">Solved</string> 
<string name="crime photo button description">Take photo of crime scene</string> 
<string name="crime_photo_no_image description"> 
Crime scene photo (not set) 
</string> 
<string name="crime photo image description">Crime scene photo (set)</string> 


</resources> 


然后 ， 打 开 res/layout/fragment_crime.xml 文 件 ， 参 照 代码 清单 19-2， 给 这 两 个 组 件 添加 
android:contentDescription 属 性 。 


代码 清单 19-2 为 ImageButton 和 ImageView 添 加 内 容 描 述 (res/layout/fragment crime.xml ) 


<ImageView 
android:id="@+id/crime photo" 
android:layout width="80dp" 
android:layout height="80dp" 
android:background="@android:color/darker gray" 
android:cropToPadding="true" 
android:scaleType="centerinside" 
android:contentDescription="@string/crime_photo_no_image description" /> 


<ImageButton 
android:id="@+id/crime camera" 
android:Layout width="match parent" 
android:layout height="wrap_content" 
android:src="@android:drawable/ic menu camera" 
android:contentDescription="@string/crime_photo_button_description" /> 


运行 CriminalIntent 应 用 ， 聚 焦 拍 照 按 钮 ，TalkBack 开 始 朗 读 :“ 陋 习 现 场 拍 照 按 钮 ， 连 点 两 
下 激活 。 这 下 ， 用 户 总 算 明 白 了 。 
接 下 来 ， 点 按照 片 预 览 处 〈 当前 显示 的 是 灰色 占 位 图 )。 你 可 能 以 为 辅助 聚焦 框 会 上 移 ， 但 
绿色 聚焦 框 包 围 了 整个 fragment 视 图 区 域 ， 人 
个 fragment 视 图 的 相关 信息 。 问 题 在 哪 ? 
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组 件 ， 如 Button 、CheckBox 等 ， 默 认 


组 件 需 要 手动 登记 。 设 置 android : 





19.2.2 ”实现 组 件 可 聚焦 


原来 ，ImageView 组 件 没 有 做 可 聚焦 登记 。 有 些 村 
是 可 聚焦 的 ; 而 像 ImageView 和 TextView 这 样 的 框架 
值 为 true 或 使 用 监听 器 都 可 以 让 组 件 可 聚焦 。 


focusable 属 履 
如 代码 清单 19-3 所 示 ， 登 记 ImageView 为 可 聚焦 组 件 。 


代码 清单 19-3 ”让 ImageView 可 聚焦 (res/layout/fragment crime.xml ) 


医 架 



































<ImageView 
android:id="@+id/crime _ photo" 


android:contentDescription="@string/crime _ photo no image description" 











android:focusable="true" /> 


运行 CriminalIntent 详 用 ， 点 击 crime 缩 略图 组 件 ，ImageView 终 于 可 聚焦 了 。 如 图 19-7 所 示 ， 
TalkBack 读 道 :“crime 陋 习 现 场 照片 ， 当 前 未 拍照 。” 


人 NO 


BRAN 





€ Criminallntent 





crime 陋 习 现 场 
照片 ， 当 前 未 





TITLE 











Ro 
拍照 
Enter a title for the crime. 
[o] 
DETAILS 
FRI DEC 09 12:45:36 EST 2016 
口 soved 


CHOOSE SUSPECT 


SEND CRIME REPORT 








图 19-7 ”可 聚焦 的 ImageView 


19.3 ”提升 辅助 体验 


有 些 UI 组 件 ， 如 ImageView， 虽然 会 给 用 户 提供 一 些 信 息 , 但 没有 文字 性 内 容 。 你 也 应 该 给 











3 它 的 内 容 描 述 设置 为 


UL 











这 些 组 件 添加 内 容 描 述 。 如 果菜 个 组 件 提 供 不 了 任何 有 意义 的 说 明 ， 应 该 
null， 让 TalkBack 直 接 忽 略 它 。 
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你 可 能 会 认为 ,， 反正 用 户 看 不 见 , 管 它 是 不 是 图 片 ， 知道 了 又 如 何 ? 这 种 想法 不 对 。 作 为 开 
发 人 员 , 理应 让 所 有 用 户 都 能 用 到 应 用 的 全 部 功能 ， 获 得 同样 的 信息 。 要 有 不 同 , 那 也 是 自身 体 
验 和 使 用 方式 上 的 差异 。 

好 的 辅助 易 用 设计 不 是 一 字 不 漏 地 读 屏幕 。 相 反 , 应 注重 用 户 体验 的 一 致 性 。 重 要 的 信息 和 
上 下 文 一 定 要 全 部 传达 。 

现在 ，crime 预 览 图 就 给 了 用 户 不 好 的 体验 。 即 使 有 照片 ,TalkBack 也 总 说 当前 未 拍照 。 现 在 
我 们 一 起 感受 一 下 。 点 按 拍照 按钮 ， 然 后 连 点 屏幕 两 次 激活 ， 相 机 应 用 启动 了 ，TalkBack 说 道 : 
“拍照 。” 点 按 并 激活 快门 按钮 拍摄 一 张 照 片 。 

确认 所 拍照 片 。( 对 于 这 个 步骤 ,不 同 的 相机 应 用 可 能 有 不 同 的 操作 。 但 不 管 怎样 ， 都 是 先 
聚焦 , 再 连 点 两 下 激活 。) crime 明 细 页 面 现 在 显示 了 刚 拍 的 照片 。 聚 焦 ImageView 视 图 , TalkBack 
读 道 :“crime 陋习 现场 照片 ， 当 前 未 拍照 。 

为 了 解决 这 个 问题 ， 让 用 户 能 听 到 正确 信息 ， 在 updatePhotoView() 方 法 里 动态 设置 
ImageView 的 内 容 描 述 ， 如 代码 清单 19-4 所 示 。 


代码 清单 19-4 动态 设置 内 容 描 述 ( CrimeFragment.java ) 


public class CrimeFragment extends Fragment { 


















































private void updatePhotoView() { 
if (mPhotoFile == null || !mPhotoFile.exists()) { 
mPhotoView.setimageDrawable (null); 
mPhotoView. setContentDescription( 
getString(R.string.crime photo no_ image description)); 
} else { 


mPhotoView.setimageBitmap (bitmap); 
mPhotoView. setContentDescription( 
getString(R.string.crime photo_ image description)); 


} 

现在 ， 只 要 有 照片 更 新 ，updatePhotoView() 方 法 都 会 设置 内 容 描 述 。 如 果 mPhotoFile 没 
值 ， 内 容 描 述 会 说 明 没 拍 照片 ， 否 则 就 明确 说 明 已 拍照 。 

运行 CriminalIntent 应 用 ， 查 看 刚 拍 过 照 的 crime 明 细 页 面 。 如 图 19-8 所 示 ， 点 按 图 片 聚 焦 ， 这 
次 ，TalkBack 说 道 :“crime 陋习 现场 照片 ， 当 前 已 拍照 。” 


使 用 label 提供 上 下 文 


继续 之 前 ， 给 新 crime 加 个 标题 。 如 图 19-9 所 示 ， 点 按 聚 焦 EditText 框 ，TalkBack 提 示 :“ 编 
辑 框 ， 请 给 crime 加 标题 。 











> 
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Criminallntent 





crime 陋 习 现 场 照 
片 ， 当 前 已 拍照 。 


| TITLE 





Enter a title for the crime. 











DETAILS 
MON DEC 12 09:12:32 EST 2016 
口 solved 
CHOOSE SUSPECT 
SEND CRIME REPORT 

















图 19-8 ”带动 态 描 述 的 可 聚焦 ImageView 


BS EY RA 


€ Criminalintent 





编辑 框 ， 请 给 











crime 加 标题 。 

| TITLE 

Enter atitle forthe crime. 
DETAILS 

MON DEC 12 09:12:32 EST 2016 
口 soved 
CHOOSE SUSPECT 
SEND CRIME REPORT 








图 19-9 ”EditText 提 示 
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TalkBack 默 认 读 出 EditText 框 里 的 内 容 。 没 输入 标题 之 前 ，TalkBack 会 读 出 android:hint 
器 定 的 内 容 。 所 以 不 需要 也 不 应 该 给 EditText 设 置 内 容 描述 。 

然而 ， 这 实际 是 有 问题 的 。 眼 见 为 实 ， 在 标题 栏 里 输入 文字 : Sticker vandalism"。 然 后 ， 点 
按 聚 焦 EditText 框 ，TalkBack 提 示 : “编辑 框 ，Sticker vandalism。” 

















BM EN RA 
编辑 框 ,Sticker € Criminallntent 
vandalism 。 
TITLE 
| 
Sticker vandalism 
丙 

DETAILS 
MON DEC 12 09:12:32 EST 2016 

口 soved 


CHOOSE SUSPECT 


SEND CRIME REPORT 








图 19-10” 带 crime 标 题 的 EditText 


这 个 问题 就 是 ， 如 果 输 入 了 其 他 文字 ，TalkBack 使 用 者 就 失去 了 上 下 文 ， 不 知道 EditText 
框 到 底 是 做 什么 的 。 这 对 于 视力 好 的 人 来 说 一 目 了 然 , 因为 上 面 有 标题 文字 标签 。 如 果 就 输入 了 
简单 标题 ， 有 视力 障碍 的 用 户 就 要 费力 猜测 了 。 显 然 ， 使 用 体验 就 有 了 大 差异 。 

可 以 很 容易 地 标明 EditText 和 TextView 的 关系 ， 让 TalkBack 掌 握 同 样 的 上 下 文 关 系 。 只 要 
给 TextView 添 加 android:LabeLFor 属 性 就 可 以 了 ， 如 代码 清单 19-5 所 示 。 


















































代码 清单 19-5 ”给 EditText 打 标签 (res/layout/fragment crime.xml ) 


<TextView 
style="?android:listSeparatorTextViewStyle" 
android:Layout width="match parent" 
android:layout height="wrap_content" 
android:text="@string/crime title label" 
android:labelFor="@+id/crime title"/> 


android:LabeLFor 属 性 告诉 TalkBack，TextView 是 以 某 个 ID 值 指 定 的 视图 ( EditText ) 的 
标签 。labelFor 定 义 在 View 类 里 ， 所 以 可 以 任意 两 个 View 互 打 标 签 。 注 意 ， 这 里 必须 使 用 @+id 
































g) 意 即 “贴纸 被 故意 破坏 ”。 一 一 编者 注 
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这 样 的 语法 ， 因 为 我 们 正 引用 了 一 个 当前 还 没 定义 的 卫 值 。 可 以 删除 EditText 定 义 中 
android:id="@+tid/crime_title" 这 行 代码 里 的 + 号 ， 不 过 ， 留 着 也 不 会 有 问题 。 

运行 应 用 。 点 按 聚 售 EditText 框 ，TalkBack 提 示 :“ 编 辑 框 ，Sticker vandalism， 用 于 crime 
标题 。” 

恭喜 ! 现在 , 应 用 的 易 用 性 有 了 很 大 改善 。 很 多 开发 人 员 总 是 找 借口 说 ,对 辅助 功能 这 块 不 
熟悉 , 所 以 不 愿 为 特殊 人 和 群 提高 应 用 的 易 用 性 。 你 看 到 了 , 让 应 用 更 好 地 支持 TalkBack 没 那么 难 。 
而 且 ， 有 了 改善 TalkBack 的 基础 和 经 验 ， 就 更 容易 学 会 改善 其 他 辅助 功能 ， 比 如 BrailleBack。 

设计 和 实现 具有 辅助 功能 的 应 用 容易 让 人 望而却步 。 要 知道 ,在 这 个 领域 , 可 是 有 好 多 专职 
工程 师 的 。 不 过 ,与 其 害怕 做 不 好 而 直接 忽略 ， 不 如 从 基本 做 起 : 确保 将 屏幕 上 有 意义 的 信息 都 
传达 给 TalkBack 用 户 ; 确保 给 予 TalkBack 用 户 充分 的 上 下 文 信息 。 不 要 让 他 们 浪费 时 间 听 废话 。 
当然 ， 最 重要 的 是 ， 倾 听 用 户 ， 虚 心 学 习 。 

至 此 ，CriminalIntent 应 用 完成 了 。 历经 13 章 ,我 们 创建 了 一 个 复杂 的 应 用 ， 它 使 用 fragment， 
支持 应 用 间 通 信 ， 可 以 拍照 ， 可 以 保存 数据 ， 甚 至 说 中 文 。 吃 块 蛋糕 庆祝 一 下 吧 ! 

不 过 ， 吃 完 记得 清理 现场 ， 好 习惯 要 养 成 ， 人 人 都 是 监督 者 。 


19.4 深入 学 习 : 使 用 辅助 功能 扫描 器 


本 章 ， 我 们 专注 于 让 TalkBack 用 户 更 方便 地 使 用 应 用 。 不 过 ， 这 还 没完 ， 照 顾 视 力 障碍 人 和 群 
只 是 做 了 辅助 工作 的 一 小 部 分 。 

理论 上 , 测试 应 用 的 辅助 功能 得 靠 真 正 每 天 在 用 辅助 服务 的 用 户 。 但 即使 现实 不 允许 ,也 应 
竭尽 所 能 。 

为 此 ，Google 提 供 了 一 个 辅助 功能 扫描 器 。 它 能 评估 应 用 在 辅助 功能 方面 做 得 如 何 并 给 出 改 
进 意见 。 现 在 拿 CriminalIntent 应 用 做 个 测试 。 

首先 ， 访问 play.google.com/store/apps/details?id=com.google.android.apps.accessibility.auditor， 
按 指导 安装 扫 描 器 。 

安装 完成 后 , 手机 屏幕 上 会 出 现 一 个 蓝 色 的 打 勾 图 标 。 好 戏 开 始 了 , 启动 CriminalIntent 应 用 ， 
先 不 用 管 蓝 色 的 打 勾 图 标 ， 直 接 进 入 应 用 的 crime 明 细 页 面 ， 如 图 19-11 所 示 。 

点 按 蓝 色 的 打 色 图标, 辅助 功能 扫描 器 开始 工作 。 分 析 时 会 看 到 进度 条 ,一旦 完成 , 会 弹出 
一 个 窗口 给 出 建议 ， 如 图 19-12 所 示 。 























































































































































































































310 第 19 章 Android 辅助 功能 





BN AY 


€ Criminalintent 











YAR7:00 
X 5suggestions 性 ~ 


i700 
€ Criminalintent 


























Ee ne 
| a A 
| io a neezed on keyboard 
Tr TITLE 
[©o] Sneezed on keyboard 
DETAILS 商 
WED DEC 07 09:25:06 EST 2016 DETAILS 
口 sowed WED DEC 07 09:25:06 EST 2016 
口 soved 
CHOOSE SUSPECT 
CHOOSE SUSPECT 
SEND CRIME REPORT ee 


4 | 





图 19-11 ”启动 CriminalIntent 应 用 待 分 析 图 19-12 ”辅助 功能 扫描 器 分 析 结 果 


























可 以 看 到 ImageView、EditText 和 CheckBox 都 带 框 。 这 表明 ， 扫 描 器 认为 这 三 个 组 件 有 洪 
在 的 辅助 功能 问题 。 点 按 EditText 查 看 它 的 问题 ， 如 图 19-13 所 示 。 





YA R70 
€ Element2 =: 


3 suggestions 
com.bignerdranch.android. criminalintent:id/c.. 


B® Touchtarget ~ 
Consider making this clickable item larger. 


目 ltem descriptions v 
Multiple items have the same description. 


QQ Text contrast v 


Consider increasing this item’s text foreground 
to background contrast ratio. 


中 





图 19-13 ”EditText 辅 助 功能 改进 意见 
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辅助 功能 扫描 器 有 三 个 建议 。 第 一 个 与 EditText 的 尺寸 有 关 。 对 所 有 触摸 类 组 件 ， 推 荐 的 
最 小 尺寸 是 48dp。EditText 的 高 度 不 够 ,修改 很 容易 ， 指 定 它 的 android:minHeight 属 性 就 可 
以 了 。 

第 二 个 和 label 有 关 。 扫 描 器 说 ， 标 题 TextView 和 EditText 提 供 的 信息 宛 余 ， 因 为 这 两 个 组 
件 和 有 关联 。 这 里 ， 扫 描 器 说 的 元 余 不 是 问题 ， 忽 略 这 个 建议 。 

最 后 一 个 是 关于 文字 颜色 和 其 背景 色 的 对 比 。 有 不 少 工具 可 以 基于 明亮 度 估 测 两 种 色 有 
比 度 。 另 外 ， 也 有 一 些 网 站 ， 如 randomallycom， 按 照 易 用 对 比 度 标准 ， 列 出 很 多 颜色 组 合 
些 标 准 是 怎么 订 的 呢 ? 万 维 网 联盟 (一 个 为 Web 设 计 制 定 开放 标准 的 国际 社区 ) 推荐 ， 区 
或 更 小 的 文字 ， 至 少 要 有 4.5 : 1 的 对 比 度 。CriminalIntent 应 用 的 EditText 的 颜色 对 比 度 是 3.52。 
要 处 理 这 个 问题 ， 调 整 其 android:textColor 属 性 和 android:background 属 性 就 可 以 了 。 

想 更 深入 了 解 扫 描 器 的 推荐 ， 可 点 按 右边 的 向 下 箭头 查看 细节 ， 再 点 Learn More 链 接 。 


19.5 ”挑战 练习 : 优化 列表 项 


TalkBack 会 读 出 每 条 crime 记 录 的 标题 和 发 生日 期 ， 但 漏 了 crime 是 否 已 解 
决 这 一 信息 。 给 手 钱 图 标 添 加 内 容 描述 ， 解 决 这 个 问题 

对 于 每 条 crime 记 录 ，TalkBack 都 要 花 点 时 间 来 读 ， 这 是 因为 日 期 格式 那么 长 ,而 且 是 否 已 解 
决 标志 位 于 最 右边 。 现 在 , 再 挑战 一 下 自己 ,为 屏幕 上 的 每 条 记录 都 动态 添加 一 个 待 读数 据 的 汇 
总 内 容 描 述 。 


19.6 ”挑战 练习 : 补 全 上 下 文 信息 


日 期 按钮 和 选择 联系 人 按钮 都 有 类 似 标题 EditText 的 问题 。 无 论 是 否 使 用 TalkBack, 用 户 都 
不 是 太 明 确 按钮 上 是 什么 的 日 期 。 同 样 , 选 了 联系 人 作为 嫌疑 人 后 ， 用户 也 可 能 不 知道 联系 人 按 
钮 的 作用 是 什么 。 用 户 也 许 能 猜测 出 来 ， 但 为 什么 要 让 用 户 猜 呢 ? 

这 就 是 设计 的 微妙 之 处 。 你 或 设计 团队 应 该 拿 出 最 好 的 方案 ， 平 衡 易 用 和 简约 的 关系 。 

作为 练习 ， 请 修改 明细 页 面 的 设计 ， 让 用 户 充分 把 握 数据 和 按钮 间 的 上 下 文 关系 。 和 处 理 
EditText 标 题 一 样 ， 你 可 以 为 每 个 组 件 都 添加 label 标 签 ， 或 者 完全 重新 设计 明细 页 面 。 怎 么 做 ， 
自己 选 。 总 之 ， 不 要 止步 于 眼前 ， 要 敢于 对 不 好 的 说 不 ， 应 用 优化 无 止境 。 


19.7 挑战 练习 : 事件 主动 通知 


给 ImageView 添 加 动态 内 容 描述 后 ，crime 缩 略图 组 件 的 TalkBack 体 验 获得 极 大 改善 。 但 是 ， 
TalkBack 用 户 必须 等 点 按 并 聚焦 ImageView 之 后 ， 才 知道 照片 是 否 已 拍 或 已 更 新 。 而 视力 正常 的 
用 户 ， 返回 时 就 能 看 到 照片 更 新 情况 。 

你 可 以 提供 类 似 体验 ,让 TalkBack 用 户 在 相机 关闭 时 就 能 掌握 照片 更 新 情况 。 查 阅 文档 研究 
一 下 View.announceForAccessibility(...) 方 法 ， 看 看 怎么 在 CriminalIntent 应 用 里 使 用 。 
或 许 你 ty Rest . ) 方 法 里 通知 。 若 要 这 样 做 ,会 有 与 activity 生 命 
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周期 相关 的 时 间 点 掌控 方面 的 问题 要 处 理 。 不 过 ， 启 动 一 个 Runnable ( 详 见 第 26 章 )， 做 个 延 时 
处 理 可 以 绕 开 这 个 问题 。 以 下 给 出 参考 代码 : 
mSomeView.postDelayed(new Runnable() { 
@Override 


public void run() { 
// Code for making announcement goes here 





} 
}, SOME DURATION IN MILLIS); 


你 也 可 以 避 开 使 用 Runnable ， 想 个 办 法 确定 发 出 通知 的 准确 时 间 点 。 例 如 ， 可 考虑 在 
onResume ( ) 方 法 里 通知 。 当 然 ， 前 提 是 ， 你 需要 跟踪 掌握 用 户 是 否 刚 从 相机 应 用 退出 。 
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开发 GeoQuiz 应 用 和 CriminalIntent 应 用 时 ， 我 们 使 用 了 Android 标 准 工具 : 由 Java 对 象 组 成 的 
模型 层 、 视 图 层级 结构 ， 以 及 控制 句 对 象 (activity 和 fragment )。 对 于 这 两 个 项 目 ，MVC 架 构 很 





适用 。 


本 章 ， 我 们 学习 数 据 绑 定 ( data binding ) 这 个 新 工具 。 数 据 绑 定 只 是 一 个 工具 ， 它 不 会 告诉 








你 怎么 去 用 ,不 过 ,我 们 知道 ,所 以 ,我们 会 教 你 如 何在 1 


(MVVM ) 新 架构 。 此 外 ， 你 还 会 学 习 使 用 资源 系统 





项 目 里 使 用 它 :实现 Model-View-ViewModel 
(assets system ) 存储 声音 文件 。 


























我 们 将 在 本 章 开始 开发 一 个 叫 作 BeatBox 的 新 应 用 ( 如 图 20-1 所 示 )。BeatBox 不 是 传统 意义 
上 的 音乐 节拍 盒 ， 而 是 一 个 能 帮 你 打败 对 手 的 神奇 盒子 。 不 过 ， 它 不 会 让 你 做 出 狂 舞 用 膊 、 人 至 人 
受伤 的 危险 事 。 实 际 上 ， 它 的 作用 出 人 意料 : 发 出 一 种 特殊 的 声响 ， 直 到 对 手 求 侯 为 止 。 


BS Ea) 
BeatBox 








65_CJIPIE 66_INDIOS 
68_INDIOS3 69_OHM-LOKO 
71_HRUUHB 72_HOUB 

74_JAH 75_JHUEE 

77_JUOB 78_JUEB 











67_INDIOS2 


70_EH 


73_HOUU 


76_JOOOAAH 


79_LONG- 
SCREAM 





图 20-1 ”本章 要 完成 的 BeatBox 应 用 的 效果 
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20.1 为 何 要 用 MVVM 架构 


目前 为 止 ， 我 们 开发 的 应 用 都 使 用 了 简单 版 的 MVC 架 构 。 而 且 ， 没 出 什么 丝 漏 的 话 ， 应 用 
都 运行 良好 ， 让 人 挺 有 成 就 感 。 那 么 为 何 要 改变 ”有 什么 问题 吗 ? 

本 书 实现 的 MVC 架 构 比 较 适 合 小 规模 、 简 单 型 的 应 用 。 它 方便 开发 人 员 理 清 项 目 结构 ， 快 
速 添加 新 功能 ， 为 开发 打下 坚实 基础 。 应 用 因此 得 以 快速 完成 并 投入 使 用 , 在 项 目的 早期 阶段 能 
保持 稳定 运行 。 

和 所 有 项 目 一 样 ， 需 求 不 断 提 出 ， 应 用 一 天 比 一 天 复杂 。fragment 和 activity 开 始 膨胀 ， 逐 渐 
变 得 难以 理解 和 扩展 。 添 加 新 功能 或 改 bug 需 要 耗费 很 长 时 间 。 这 个 时 候 ， 控 制 器 层 就 需要 做 功 
能 拆 分 了 。 
怎么 拆 ? 先 搞 清楚 控制 器 类 到 底 做 了 哪些 工作 , 再 把 这 些 工作 拆 分 到 独立 的 小 类 里 。 让 一 个 
个 拆 开 的 小 类 协同 工作 。 

那么 , 如 何 确定 控制 器 类 的 不 同 使 命 呢 ?” 你 的 架构 可 以 给 你 答案 。 人 们 给 出 高 度 概括 的 MVC 
(模型 -视图 -控制 器 ) 或 者 MVP (模型 -视图 -展示 器 ) 的 说 法 , 这 些 就 是 他 们 给 这 个 问题 的 答案 。 
无 论 如 何 ， 你 的 架构 你 自己 最 清楚 ， 如 何 答题 就 看 你 了 。 

BeatBox 应 用 使 用 MVVM 架 构 。 我 们 是 MVVM 架 构 的 支持 者 。 MVVM 架 构 很 好 地 把 控制 器 里 
的 腔 肿 代码 抽 到 布局 文件 里 ,让 开发 人 员 很 容易 看 出 哪些 是 动态 界面 。 同时, 它 也 抽出 部 分 动态 
控制 器 代码 放 入 ViewModet 类 ， 这 大 大 方便 了 开发 测试 和 验证 。 

每 个 视图 模型 应 控制 成 多 大 规模 ， 这 要 具体 情况 具体 分 析 。 如 果 视 图 模型 过 大 ,你 还 可 以 继 
续 拆 分 。 总 之 ， 你 的 架构 你 把 控 。 即 使 大 家 都 用 MVVM 架 构 ， 业 务 不 同 ， 场 景 不 一 样 ， 每 个 人 
的 具体 实现 方法 都 有 差异 。 





































































































20.2 创建 BeatBox 应 用 


在 Android Studio 中 ， 选 择 File 一 New 一 New Project... 菜 单项 创建 新 项 目 。 项 目 名 称 是 
BeatBox ， 公 司 域 名 是 android.bignerdranch.com ， 最 低 SDK 版 本 是 API 19。 新 建 一 个 名 为 
BeatBoxActivity 的 空 activity， 其 余 默 认 项 保持 不 变 ， 完 成 项 目 创建 。 

BeatBox 应 用 会 用 到 RecyclerView。 因 此 ， 打 开 项 目 设置 添加 com.android.support: 
recyclerview-v7 依 赖 项 。 

在 界面 设计 方面 , 应 用 主屏 幕 会 显示 一 排 排 可 以 播放 声音 的 按钮 。 因此, 需要 两 个 布局 文件 ， 
分 别 用 于 网 格 和 按钮 。 

首先 创建 RecyclerView 布 局 文件 。 向 导 产 生 的 res/layout/activity_beat_box.xml 没 用 ， 因 此 直 
接 改 名 为 fragment_beat_box.xml。 然 后 ， 参 照 代码 清单 20-1 完 成 布局 定义 。 


代码 清单 20-1 创建 主 布局 文件 (res/layout/fragment beat box.xml ) 


<android.support.v7 .widget.RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 
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android:id="@+id/recycler_ view" 
android:layout width="match_parent" 
android:layout_ height="match_parent"/> 


现在 ， 在 com.bignerdranch.android.beatbox 包 中 ， 创 建 名 为 BeatBoxFragment 的 新 Fragmentt， 
如 代码 清单 20-2 所 示 。 





代码 清单 20-2 ”创建 BeatBoxFragment ( BeatBoxFragment.java ) 
public class BeatBoxFragment extends Fragment { 
public static BeatBoxFragment newInstance() { 
return new BeatBoxFragment(); 

} 

这 个 fragment 实 现 先 空 着 ， 稍 后 处 理 。 

接 下 来 ， 创 建 托管 fagment 的 BeatBoxActivity。 这 里 ，BeatBoxActivity 同 样 是 直接 继承 
Criminalmtent 应 用 中 用 过 的 SingLeFragmentActivity 类 。 

首先 ， 找 到 CriminalIntent 项 目的 SingleFragmentActivity.java 和 activity_fragment.xml 这 两 个 文 
件 , 将 其 分 别 复制 到 com.bignerdranch.android.beatbox 包 和 app/src/main/res/layout/ 目 录 。( 从 你 自己 
的 CriminalIntent 应 用 文件 夹 或 者 随 书 文件 中 找到 这 些 文件 。) 
然后 ， 清 空 BeatBoxActivity 类 中 的 所 有 内 容 ， 改 为 继承 SingleFragmentActivity 类 ,并 
覆盖 createFragment () 方 法 ， 如 代码 清单 20-3 所 示 。 




















代码 清单 20-3 ”实现 BeatBoxActivity ( BeatBoxActivity.java ) 


public class BeatBoxActivity extends SingLeFragmentActivity { 
@Override 


protected Fragment createFragment() { 
return BeatBoxFragment .newInstance() ; 


} 


简单 的 数据 绑 定 


接 下 来 的 任务 是 实例 化 fragment beat box.xml 并 与 RecycterView 关 联 起 来 .这 类 任务 以 前 做 
过 。 这 次 ， 我 们 改 用 数据 绑 定 来 做 ， 相 比 之 前 ， 会 更 方便 快捷 。 

首先 ， 在 应 用 的 build.gradle 文 件 里 启用 数据 绑 定 ， 如 代码 清单 20-4 所 示 。 
代码 清单 20-4 ”启用 数据 绑 定 ( app/build.gradle ) 


versionCode 1 
versionName "1.0" 
testinstrumentationRunner "android.support.test. runner.AndroidJUnitRunner" 





} 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
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'proguard-rules.pro’ 
} 
} 
dataBinding { 
enabled = true 
} 
} 


dependencies { 

这 会 打开 IDE 的 整合 功能 ， 人 允许 你 使 用 数据 绑 定 产 生 的 类 ， 并 把 它们 整合 到 编译 里 去 。 

要 在 布局 里 使 用 数据 绑 定 , 首先 要 把 一 般 布局 改造 为 数据 绑 定 布局 。 具 体 做 法 就 是 把 整个 布 
局 定义 放 入 <layout> 标 签 ， 如 代码 清单 20-5 所 示 。 


代码 清单 20-5 ”把 一 般 布 局 改造 为 数据 绑 定 布局 (res/layout/fragment_beat_box.xml ) 


<Layout 
xmlns:android="http://schemas.android.com/apk/res/android"> 
<android.support.v7.widget.RecyclerView 






































android:id="@+id/recycler view" 

android:layout width="match parent" 

android:layout height="match parent"/> 
</Layout> 


<Layout> 告 诉 数据 绑 定 工具 :“ 这 个 布局 由 你 来 处 理 。 接 到 任务 , 数据 绑 定 工具 会 帮 你 生成 
一 个 绑 定 类 (binding class )。 新 产生 的 绑 定 类 默认 以 布局 文件 命名 。 当 然 ， 不 是 snake_case 这 种 
格式 ， 而 是 CamelCase 格 式 ( 类 名 嘛 )。 
现在 , fragment_beat_box.xml 已 经 有 了 一 个 叫 FragmentBeatBoxBinding 的 绑 定 类 。 这 就 是 要 
用 来 做 数据 绑 定 的 类 : 现在， 实例 化 视图 层级 结构 时 ， 不 再 使 用 LayoutInflater， 而 是 实例 化 
FragmentBeatBoxBinding 类 。 在 一 个 叫 作 getRoot ( ) 的 getter 方 法 里 , FragmentBeatBoxBinding 
引用 着 布局 视图 结构 ， 而 且 也 会 引用 那些 在 布局 文件 里 以 android :id 标签 引用 的 其 他 视图 。 

所 以 ，FragmentBeatBoxBinding 类 有 两 个 引用 : getRoot() 和 recyclerView， 前 者 指 整 
个 布局 ， 后 者 指 RecyclerView， 如 图 20-2 所 示 。 























FragmentBeatBoxBinding 





getRoot() recyclerView 


RecyclerView 


图 20-2 ”FragmentBeatBoxBinding 绑 定 类 
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你 的 布局 只 有 一 个 视图 ， 所 以 两 个 引用 都 指向 了 同一 个 视图 : RecyclerView。 

下 面 开 始 使 用 这 个 绑 定 类 。 在 BeatBoxFragment 里 , 窗 盖 onCreateView(..,.) 方 法 , 然后 使 
用 DataBindingUtil 实 例 化 FragmentBeatBoxBinding， 如 代码 清单 20-6 所 示 。( 你 需要 导入 
FragmentBeatBoxBinding 类。 如 果 Android Studio 提 示 找 不 到 ， 说明 由 于 某 种 原因 ， 
FragmentBeatBoxBinding 没 有 正常 生成 。 请 尝试 重新 编译 项 目 ， 或 重启 Android Studio。 ) 
代码 清单 20-6 ”实例 化 绑 定 类 ( BeatBoxFragment.java ) 


public class BeatBoxFragment extends Fragment { 
public static BeatBoxFragment newinstance() { 
return new BeatBoxFragment(); 
} 









































@Override 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 


Bundle savedInstanceState) { 
FragmentBeatBoxBinding binding = DataBindingUtil 


.inflate(inflater, R.layout.fragment _ beat box, container, false); 


return binding.getRoot(); 


} 





实例 化 绑 定 类 后 ， 就 可 以 获取 并 配置 RecyclerViewT。 


代码 清单 20-7 ”配置 RecyclerView ( BeatBoxFragment.java ) 


public class BeatBoxFragment extends Fragment { 
public static BeatBoxFragment newinstance() { 
return new BeatBoxFragment(); 
} 


@Override 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 


Bundle savedInstanceState) { 
FragmentBeatBoxBinding binding = DataBindingUtil 


.inflate(inflater, R.layout.fragment beat box, container, false); 
binding.recyclerView.setLayoutManager (new GridLayoutManager(getActivity(), 


3)); 
return binding.getRoot(); 


} 





数据 绑 定 完成 了 ， 这 就 是 我 们 所 说 的 简单 的 数据 绑 定 : 不 用 findViewById(...) 方 法 , 转 而 
使 用 数据 绑 定 获取 视图 。 稍 后 ， 我 们 还 会 学 习 数 据 绑 定 的 高 级 用 法 。 

接 下 来 ， 创 建 按钮 布局 文件 reslayoutlist_ item _sound.xml。 这 个 布局 也 使 用 数据 绑 定 ， 所 以 
同样 添加 <Layout> 标 签 ， 如 代码 清单 20-8 所 示 。 








| 
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代码 清单 20-8 ”创建 声音 布局 文件 (res/layout/list_item_ sound.xml ) 


<Layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<Button 
android:layout width="match _ parent" 
android:layout height="120dp" 
tools:text="Sound name"/> 
</Layout> 


接 下 来 ,创建 一 个 使 用 list_item_sound.xml 布 局 的 SoundHolder， 如 代码 清单 20-9 所 示 。 








代码 清单 20-9 ”创建 SoundHolder ( BeatBoxFragment.java ) 


public class BeatBoxFragment extends Fragment { 
public static BeatBoxFragment newinstance() { 
return new BeatBoxFragment(); 


} 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


} 


private class SoundHolder extends RecyclerView.ViewHolder { 
private ListItemSoundBinding mBinding; 


private SoundHoLder(ListItemSoundBinding binding) { 
super (binding.getRoot()); 
mBinding = binding; 


} 

SoundHoLder 要 使 用 刚才 数据 绑 定 工具 已 产生 的 绑 定 类 : ListItemSoundBinding。 

接着 ,创建 一 个 关联 SoundHolder 的 Adapter， 如 代码 清单 20-10 所 示 。( 不 要 输入 任何 方法 ， 
把 光标 移 到 RecyclerView.Adapter 上 ， 按 Option+Return 或 AlttEnter 组 合 键 ，Android Studio 会 自 
动 完成 大 部 分 代码 。) 
代码 清单 20-10 ”创建 SoundAdapter ( BeatBoxFragment.java ) 


public class BeatBoxFragment extends Fragment { 








private class SoundHolder extends RecyclerView.ViewHolder { 


} 


private class SoundAdapter extends RecyclerView.Adapter<SoundHolder> { 
@Override 
public SoundHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
LayoutInflater inflater = LayoutInflater.from(getActivity()); 
ListItemSoundBinding binding = DataBindingUtil 
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.inflate(inflater, R.layout.list item sound, parent, false); 
return new SoundHolder (binding); 


} 


@Ove D ride 20 


public void onBindViewHolder(SoundHolder holder, int position) { 





} 


@Override 
public int getItemCount() { 
return 0; 


} 


} 
现在 ， 在 onCreateView(...) 方 法 中 使 用 SoundAdapter， 如 代码 清单 20-11 所 示 。 


代码 清单 20-11 使 用 SoundAdapter ( BeatBoxFragment.java ) 


GOverride 
public View onCreateView(layoutinflater inflater, ViewGroup container, 
Bundle savedinstanceState) { 
FragmentBeatBoxBinding binding = DataBindingUtil 
.inflate(inflater, R.layout.fragment beat box, container, false); 


binding.recyclerView.setlayoutManager(new GridlayoutManager(getActivity(), 3)); 
binding.recyclerView.setAdapter (new SoundAdapter()); 


return binding.getRoot(); 


20.3 导入 assets 


现在 , 需要 把 声音 文件 添加 到 项 目 里 ,以便 应 用 调用 。 不 过 ,这 里 不 打算 用 资源 系统 ， 我 们 
改 用 assets 打 包 声 音 文件 。 可 以 把 assets 想 象 为 经 过 精简 的 资源 : 它们 也 像 资 源 那样 打 人 APK 包 ， 
但 不 需要 配置 系统 工具 管理 。 

使 用 assets 有 了 两面性 : 一 方面 ， 无 需 配 置 管理 ， 可 以 随意 命名 assets， 并 按 自 己 的 文件 结构 组 
织 它们 ; 男 一 方面 ,没有 配置 管理 ,无 法 自动 响应 屏幕 显示 密度 、 语 言 这 样 的 设备 配置 变更 ， 自 
然 也 就 无 法 在 布局 或 其 他 资源 里 自动 使 用 它们 了 。 

所 以 , 总体 上 讲 , 资源 系统 是 更 好 的 选择 。 然 而 , 如果 只 想 在 代码 中 直接 调用 文件 , 那么 assets 
就 有 优势 了 。 大 多 数 游戏 就 是 使 用 assets 加 载 大 量 网 片 和 声音 资源 ，BeatBox 也 这 样 。 

现在 我 们 来 导入 assets。 首 先 创建 assets 目 录 。 右键 单 击 app 模 块 ， 选择 New 一 Folder 一 Assets 
Folder 菜 单项 ， 弹 出 如 图 20-3 所 示 的 画面 。 不 勾 选 Change Folder Location 选 项 ， 保 持 Target Source 
Set 的 main 选 项 不 变 ， 单 击 Finish 按 钮 完成 。 
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©e New Android Activity 





ZX Customize the Activity 


Creates a source root for assets which will be included in the APK. 


DD Change Folder Location 


Target Source Set: main $ 


Change the folder location to another folder within the module. 


Cancel | Previous | Next [CFinish 
图 20-3 ”创建 assets 目 录 


接着 ， 右 键 单 击 assets 目 录 ， 选 择 New 一 Directory 菜 单项 ， 为 声音 资源 创建 sample_sounds 子 
目录 ， 如 图 20-4 所 示 。 


@0e@ New Directory 








Enter new directory name: 





a sample_sounds | 


Cancel (a 





图 20-4 ”创建 sample sounds 子 目录 


assets 目 录 中 的 所 有 文件 都 会 随 应 用 打包 。 为 了 方便 组 织 文 件 ， 我 们 创建 了 sample_sounds 子 
目录 。 与 资源 不 同 ， 子 目录 不 是 必需 的 ， 这 里 是 为 了 组 织 声音 文件 。 

声音 文件 哪里 找 呢 ? 在 www.ffeesound.org 网 站 。plagasul 是 这 个 网 站 的 用 户 ， 基 于 创作 共用 
许可 ， 他 发 布 了 一 套 声音 文件 ( www.freesound.org/people/plagasul/packs/3/ )。 我 们 已 重新 打包 提 
供 。 请 使 用 以 下 地 址 获取 : https://www.bignerdranch.com/solutions/sample_sounds.zip。 

下 载 并 解压 缩 文 件 至 assets/sample_sounds 目 录 ， 如 图 20-5 所 示 。 
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局 Android 加 | 
v Caapp 
Pp Dmanifests 
> Cares 
v Caassets 
Vv [sample_sounds 








65_Cjipie.wav 
66_indios.wav 


67_indios2.wav 
68_indios3.wav 


69_ohm-loko.wav 


70_eh.wav 
71_hruuhb.wav 
72_houb.wav 


区 酒 民 3 


[C3 


73_houu.wav 


74_jah.wav 





75 ihuaa wav 


图 20-5 已 导入 的 assets 


(确保 这 里 只 有 .wav 文 件 ， 而 非 尚未 解压 的 .zip 文 件 。 ) 
重新 编译 应 用 ， 确 保 一 切 正常 。 接 下 来 编写 代码 ， 列 出 所 有 这 些 资源 并 展示 给 用 户 。 











20.4 ”处 理 assets 


assets 导 人 后 ,还 要 能 在 应 用 中 进行 定位 、 管 理 记 录 以 及 播放 。 这 需要 新 建 一 个 名 为 BeatBox 
的 资源 管理 类 。 如 代码 清单 20-12 所 示 ， 在 com.bignerdranch.android.beatbox 包 中 创建 这 个 类 ， 并 
添加 两 个 常量 : 一 个 用 于 日 志 记录 ， 另 一 个 用 于 存储 声音 资源 文件 目录 名 。 


代码 清单 20-12 ”创建 BeatBox 类 ( BeatBox.java) 


public class BeatBox { 
private static final String TAG = "BeatBox"; 





private static final String SOUNDS_FOLDER = "sample_sounds"; 
} 


使 用 AssetManager 类 访问 assets。 可 以 从 Context 中 获取 它 。 既 然 BeatBox 需 要 ,不 妨 添加 一 
个 带 Context 参 数 的 构造 函数 获取 并 留存 它 ， 如 代码 清单 20-13 所 示 。 


代码 清单 20-13 ”获取 AssetManager 备 用 ( BeatBox.java) 


public class BeatBox { 
private static final String TAG = "BeatBox"; 





NY 





private static final String SOUNDS FOLDER = "sample sounds"; 


private AssetManager mAssets; 
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public BeatBox(Context context) { 
mAssets = context.getAssets(); 
} 
} 


通常 ,在 访问 assets 时 ， 可 以 不 用 关心 究竟 使 用 哪个 Context 对 象 。 这 是 因为 ， 在 实践 中 的 任 
何 场景 下 ， 所 有 Context 中 的 AssetManager 都 管理 着 同一 套 assets 资 源 。 

要 取得 assets 中 的 资源 清单 ， 可 以 使 用 List(String) 方 法 。 如 代码 清单 20-14 所 示 ， 实 现 
LoadSounds () 方 法 ， 调 用 它 给 出 声音 文件 清单 。 




















代码 清单 20-14 查看 assets 资 源 (BeatBox.java ) 


public BeatBox(Context context) { 
mAssets = context.getAssets(); 
LoadSounds (); 

} 


private void loadSounds() { 
String[] soundNames; 
try { 
soundNames = mAssets.list(SOUNDS FOLDER); 
Log.i(TAG, "Found " + soundNames.length + " sounds"); 
} catch (IOException ioe) { 
Log.e(TAG, "Could not list assets", ioe); 
return; 


} 

AssetManager.List(String) 方 法 能 列 出 指定 目录 下 的 所 有 文件 名 。 因 此 ， 只 要 传人 声音 资 
源 所 在 的 目录 ， 就 能 看 到 其 中 的 所 有 .wav 文 件 。 

为 了 验证 代码 逻辑 ， 在 BeatBoxFragment 中 创建 BeatBox 实 例 ， 如 代码 清单 20-15 所 示 。 














代码 清单 20-15 ”创建 BeatBox 实 例 ( BeatBoxFragment.java ) 
public class BeatBoxFragment extends Fragment { 
private BeatBox mBeatBox 
public static BeatBoxFragment newInstance() { 
return new BeatBoxFragment () ; 
} 
@Override 
public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


mBeatBox = new BeatBox(getActivity()); 
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运行 BeatBox 应 用 。 查看 日 志 输 出 , 看 看 列 出 了 多 少 个 声音 文件 。 随 书 文件 中 提供 了 22 个 .wav 
文件 ， 你 应 该 看 到 如 下 结果 。 


…1823-1823/com,.bignerdranch.android.beatbox I/BeatBox: Found 22 sounds 














20.5 使 用 assets 


获取 到 资源 文件 名 之 后 , 要 显示 给 用 户 看 ,最 终 还 需要 播放 这 些 声 音 文件 。 所 以 ,需要 创建 
一 个 对 象 ， 让 它 管理 资源 文件 名 、 用 户 应 该 看 到 的 文件 名 以 及 其 他 一 些 相关 信息 。 

创建 一 个 这 样 的 Sound 管 理 类 ， 如 代码 清单 20-16 所 示 。( 别 忘 了 ，Android Studio 可 自动 生 
成 getter 方 法 。) 














代码 清单 20-16 创建 Sound 对 象 ( Sound.java ) 


public class Sound { 
private String mAssetPath; 
private String mName; 


public Sound(String assetPath) { 
mAssetPath = assetPath; 
String[] components = assetPath.split("/"); 
String filename = components[components.length - 1]; 
mName = filename.replace(".wav", ""); 


} 


public String getAssetPath() { 
return mAssetPath ; 


} 


public String getName() { 
return mName; 
} 
} 


为 了 有 效 显 示 声 音 文件 名 , 在 构造 方法 中 对 其 做 一 下 处理 ,首先 使 用 String.split(String) 
方法 分 离 出 文件 名 ， 青 使 用 String.replace(String，String) 方 法 删除 .wav 后 级 。 

接 下 来 ， 在 BeatBox.loadSounds() 方 法 中 创建 一 个 Sound 列 表 ， 如 代码 清单 20-17 所 示 。 
代码 清单 20-17 创建 Sound 列 表 (BeatBox.java ) 


public class BeatBox { 


























private AssetManager mAssets,; 
private List<Sound> mSounds = new ArrayList<>(); 


public BeatBox(Context context) { 
} 


private void loadSounds() { 
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String[] soundNames; 
try { 


} catch (IOException ioe) { 
} 


for (String filename : soundNames) { 
String assetPath = SOUNDS FOLDER + "/" + filename; 
Sound sound = new Sound(assetPath); 
mSounds .add (sound); 


} 


public List<Sound> getSounds() { 
return mSounds; 


} 














再 让 SoundAdapter 与 Sound 列 表 关 联 起 来 ， 如 代码 清单 20-18 所 示 。 


代码 清单 20-18 ” 绑 定 Sound 列 表 ( BeatBoxFragment.java ) 


private class SoundAdapter extends RecyclerView.Adapter<SoundHolder> { 
private List<Sound> mSounds; 











public SoundAdapter(List<Sound> sounds) { 
mSounds = sounds; 


} 
@Override 
public void onBindViewHolder(SoundHolder soundHolder, int position) { 
} 
@Override 
public int getItemCount() { 
rteturn 0; 
return mSounds.size(); 
} 


} 
最 后 ， 在 onCreateView(,..) 方 法 中 传人 BeatBox 声 音 资源 ， 如 代码 清单 20-19 所 示 。 








代码 清单 20-19 ”传人 声音 资源 ( BeatBoxFragment.java ) 


@Override 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
FragmentBeatBoxBinding binding = DataBindingUtil 
.inflate(inflater, R.layout.fragment beat box, container, false); 


binding.recyclerView.setlayoutManager(new GridlayoutManager(getActivity(), 3)); 


binding.recyclerView.setAdapter(new SoundAdapter()}); 


binding.recyclerView.setAdapter (new SoundAdapter (mBeatBox.getSounds())); 
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return binding.getRoot(); 


现在 ， 运 行 BeatBox 应 用 ， 可 以 看 到 满 是 按钮 的 网 格 出 现 了 ， 如 图 20-6 所 示 。 


A 2:00 
BeatBox 














图 20-6 “空荡荡 的 按钮 


要 显示 按钮 文字 ， 还 需要 使 用 新 的 数据 绑 定 小 工具 。 


20.6” 绪 定 数据 
使 用 数据 绑 定 ， 我 们 还 可 以 在 布局 文件 中 声明 数据 对 象 ; 


<Layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 











<data> 
<variable 
name="crime" 
type="com.bignerdranch.android.criminalintent.Crime"/> 
</data> 
</Layout> 
然后 ， 使 用 绑 定 操作 符 6{} 就 可 以 在 布局 文件 中 直接 使 用 这 些 数据 对 象 的 值 : 
<CheckBox 


android:id="@+id/list item crime solved check box" 
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android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:layout alignParentRight="true" 


android:checked="@{crime.isSolved()}" 
android:padding="4dp"/> 


在 对 象 关系 图 中 ， 可 以 这 样 表示 (〈 图 20-7 ): 


nd 


图 20-7” 绑 定 关 系 























我 们 的 目标 是 在 按钮 上 显示 声音 文件 名 。 使 用 数据 绑 定 ， 最 直接 的 方式 就 是 绑 定 
list_item_sound.xml 布 局 文件 中 的 sound 对象， 如 图 20-8 所 示 。 


list_item_sound.xml | Sound ] 


图 20-8 ”直接 绑 定 
然而 ， 这 似乎 有 架构 问题 。 首 先 从 MVC 视 角 看 看 问题 在 哪 ， 如 图 20-9 所 示 。 





























视 模型 








list_item_sound.xml 广 -全 | 








Sound 














控制 器 





BeatBoxFragment 








图 20-9 ”断裂 的 MVC 





















































不 管 是 哪 种 架构 ， 有 一 个 指导 原则 都 一 样 : 责任 单一 性 原则 。 也 就 是 说 ,每 个 类 应 该 只 负责 
一 件 事 情 。 按 此 原则 ，MVC 是 这 样 落实 的 : 模型 表明 应 用 是 如 何 工作 的 ; 控制 需 决 定 如 何 显示 
应 用 ; 视图 显示 你 想 看 到 的 结果 。 




















使 用 如 图 20-8 所 示 的 数据 绑 定 ， 就 破坏 了 责任 划分 。 这 是 因为 Sound 模 型 对 象 不 可 避免 地 需 
要 关心 显示 问题 。 代 码 也 就 此 开始 混乱 了 。 模 型 层 代 码 和 控制 器 层 代码 里 都 是 Soundjava。 
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为 了 避免 Sound 这 样 破坏 单一 性 原则 的 情况 ， 我 们 引入 一 种 叫 作 视 图 模型 的 新 对 象 ( 配合 数 
据 绑 定 使 用 )。 视 图 模型 负责 如 何 显 示 视 图 ， 如 图 20-10 所 示 。 


视图 视图 模型 模型 20 
list_item_sound.xml 一 SoundViewModel — Sound 


可 见 属性 回调 和 监听 器 


























图 20-10 MVVM 


这 种 架构 称 为 MVVM。 从 前 控制 器 对 象 格式 化 视图 数据 的 工作 就 转 给 了 视图 模型 对 象 。 现 
在 , 使 用 数据 绑 定 , 组 件 关联 数据 就 能 直接 在 布局 文件 里 处 理 了 。 控 制 器 对 象 ( activity 或 fragment ) 
开始 负责 初始 化 布局 绑 定 类 和 视图 模型 对 象 ， 同 时 也 是 它们 之 间 的 联系 纽带 。 











20.6.1 创建 视图 模型 


首先 来 创建 视图 模型 类 。 创 建 一 个 名 为 SoundviewModet 的 新 类 ， 然 后 添加 两 个 属性 : 一 个 
Sound 对 象 ， 一 个 播放 声音 文件 的 BeatBox 对 象 ， 如 代码 清单 20-20 所 示 。 


代码 清单 20-20 ”创建 SoundViewModel 类 ( SoundViewModel.java) 


public class SoundViewModel { 
private Sound mSound; 
private BeatBox mBeatBox; 





public SoundViewModel (BeatBox beatBox) { 
mBeatBox = beatBox; 


} 


public Sound getSound() { 
return mSound; 


} 


public void setSound(Sound sound) { 
mSound = sound; 
} 
} 


新 添加 的 属性 是 adapter 要 用 到 的 接口 。 对 于 布局 , 还 需要 一 个 额外 的 方法 获取 按钮 要 用 的 文 
件 名 。 如 代码 清单 20-21 所 示 ， 加 上 这 个 方法 。 


代码 清单 20-21 添加 绑 定 方法 (SoundViewModeljava ) 


public class SoundViewModel { 
private Sound mSound; 
private BeatBox mBeatBox; 
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public SoundViewModel (BeatBox beatBox) { 
mBeatBox = beatBox; 


} 


public String getTitle() { 
return mSound.getName(); 


} 


public Sound getSound() { 
return mSound; 


20.6.2 ” 绑 定 至 视图 模型 


现在 ， 把 视图 模型 整合 到 布局 文件 里 。 第 一 步 是 在 布局 文件 里 声明 属性 ， 如 代码 清单 20-22 
所 示 。 


代码 清单 20-22 ”声明 视图 模型 属性 ( list_item_sound.xml ) 


<Layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<data> 
<variable 
name="viewModel" 
type="com.bignerdranch.android.beatbox.SoundViewModel"/> 























</data> 
<Button 


这 在 绑 定 类 上 定义 了 一 个 叫 viewModet 的 属性 ， 同 时 还 包括 getter 方 法 和 setter 方 法 。 在 绑 定 
类 里 ， 可 以 用 绑 定 表达 式 使 用 viewModet。 


代码 清单 20-23” 绑 定 按钮 文件 名 (list_item sound.xml ) 


<Layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<data> 
<variable 
name="viewModel" 
type="com.bignerdranch.android.beatbox.SoundViewModel"/> 











</data> 
<Button 
android:Layout width="match parent" 
android:layout height="120dp" 
android:text="@{viewModel .title}" 
tools:text="Sound name"/> 
</layout> 


在 绑 定 表达 式 里 ， 可 以 写 一 些 简 单 的 Java 表 达 式 ， 如 链 式 方法 调用 、 数 学 计算 等 。 另 外 ,也 
可 以 吃 几 颗 “语法 糖 ”。 例 如 ， 上 述 viewModetL.titte 实 际 就 是 viewModeL,.getTittLe() 的 简写 
形式 。 数 据 绑 定 知道 怎么 帮 你 翻译 。 
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最 后 一 步 就 是 关联 使 用 视图 模型 。 创建 一 个 SoundViewModel， 把 它 添加 给 绑 定 类 ， 然 后 在 
SoundHotLder 里 添加 一 个 绑 定 方法 ， 如 代码 清单 20-24 所 示 。 


代码 清单 20-24 关联 使 用 视图 模型 ( BeatBoxFragment.java ) 


private class SoundHolder extends RecyclerView.ViewHolder { 
private listitemSoundBinding mBinding; 





private SoundHolder(listitemSoundBinding binding) { 
super(binding.getRoot()); 
mBinding = binding; 
mBinding.setViewModel (new SoundViewModel (mBeatBox)); 
} 


public void bind(Sound sound) { 
mBinding.getViewModel().setSound(sound); 
mBinding.executePendingBindings(); 











} 
} 
在 SoundHolder 构 造 方法 里 , 我 们 创建 并 添加 了 一 个 视图 模型 。 然 后 ,在 绑 定 方法 里 ,更 新 
视图 模型 要 用 到 的 数据 。 





一 般 不 需要 调用 executePendingBindings() 方 法 。 然 而 在 这 里 ,我们 正在 RecyclerView 
里 更 新 绑 定 数据 。 考 虑 到 RecyclerView 刷 新 视图 极 快 ， 我们 迫使 布局 立即 刷新 。 这 样 ， 
RecyclerView 的 表现 就 更 为 流畅 。 

最 后 ， 实 现 onBindViewHolder(...) 方 法 以 使 用 视图 模型 ， 如 代码 清单 20-25 所 示 。 


代码 清单 20-25 ”调用 bind (Sound) 方 法 ( BeatBoxFragment.java ) 


return new SoundHolder(binding); 


} 


@Override 

public void onBindViewHolder(SoundHolder holder, int position) { 
Sound sound = mSounds.get(position); 
holder .bind(sound); 

} 


@Override 
public int getitemCount() { 
return mSounds.size(); 


运行 应 用 ， 如 图 20-11 所 示 ， 按 钮 终于 显示 文件 名 了 。 
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BLE 
BeatBox 


65_CJIPIE 66_INDIOS 67_INDIOS2 
68_INDIOS3 69_OHM-LOKO 70_EH 
71_HRUUHB 72_HOUB 73_HouU 
74_JAH 75_JHUEE 76_JOOOAAH 
77_JUoB 78_JUEB 天 


图 20-11 按钮 现在 充实 了 





20.6.3” 绪 定数 据 观察 
一 切 看 上 去 很 美 , 不 过 这 只 是 表面 。 如 图 20-12 所 示 ， 如 果 向 下 滚动 按钮 网 格 ， 问 题 就 出 现 了 。 


军 4 自 2:00 
BeatBox 











74_JAH 75_JHUEE 76_JOOOAAH 
77_JUoB 78_JUEB rN 
0 81_UEHEA 82_UHRAA 
83_UOH 84_UUEH 85_JEEH 
67_INDIOS2 


图 20-12 ”问题 暴露 


看 到 最 下 面 一 个 按钮 上 的 “67_INDIOS2” 了 吗 ? 上 面 也 有 一 个 。 上 下 反复 滚动 几 次 ， 还 能 
看 到 其 他 重复 的 文件 名 。 看 样子 是 随机 重复 。 
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在 SoundHolder.bind(Sound) 方 法 里 , 我们 更 新 了 SoundViewModel 的 Sound，, 但 布局 不 知 
道 。 而 且 ， 从 图 20-10 可 知 ， 视 图 模型 并 不 会 给 布局 反馈 信息 ， 所 以 出 现 了 上 面 的 问题 。 

现在 任务 明确 了 ， 我 们 需要 让 它们 沟通 起 来 。 这 需要 视图 模型 实现 数据 绑 定 的 0bservabte 
接口 。 这 个 接口 可 以 让 绑 定 类 在 视图 模型 上 设置 监听 器 。 这 样 ， 只 要 视图 模型 有 变化 ， 绑 定 类 立 








即 会 接 到 回调 。 












































实现 这 个 接口 理论 上 可 行 , 但 工作 量 太 大 。 有 没有 其 他 好 办 法 呢 ? 答案 是 肯定 的 。 现 在 就 一 
起 来 看 个 聪明 的 做 法 〈 使 用 数据 绑 定 的 Base0bservabtLe 类 )。 


使 用 Base0bservabtLe 类 需要 三 个 步骤 : 











(1) 在 视图 模型 里 继承 Base0bservabtLe 类 ; 


(2) 使 用 6BindabtLe 注 解 视 图 模型 里 可 绑 定 的 属性 ; 




















(3) 每 次 可 绑 定 的 属性 值 改 变 时 ， 就 调用 notifyChange () 方 法 或 notifyPropertyChanged 


(int ) 方 法 。 


在 SoundViewModeL 里 ， 让 它 继承 Base0bservabtLe 类 ， 注 解 可 绑 定 的 属性 并 调用 
notifyChange() 方 法 ， 如 代码 清单 20-26 所 示 。 








代码 清单 20-26 ” 几 行 代码 就 搞定 ( SoundViewModel.java ) 


public class SoundViewModel extends BaseObservable { 
private Sound mSound; 
private BeatBox mBeatBox; 


public SoundViewModel (BeatBox beatBox) { 
mBeatBox = beatBox; 


} 


@Bindable 


public String getTitle() { 
return mSound.getName(); 


} 


public Sound getSound() { 
return mSound; 


} 


public void setSound(Sound sound) { 
mSound = sound; 
notifyChange(); 


} 


这 里 ， 调 用 notifyChange() 方 法 ， 就 是 通知 绑 定 类 ， 视 图 模型 对 象 上 所 有 可 绑 定 属性 都 已 














更 新 。 据 此 ， 绑 定 类 会 














setText (String ) 方 法 。 


次 运行 绑 定 表达 式 更 新 视图 数据 。 所 以 ，setSound(Sound) 方 法 一 被 调 
用 ，ListItemSoundBinding 就 立即 知道 ， 并 调用 list item sound.xml 布 局 里 指定 的 Button 





上 面 ,我 们 提 到 过 男 一 个 方法 :notifyPropertyChanged (int)。 这 个 方法 和 notifyChange() 

















方法 做 同样 的 事 , 但 覆盖 面 不 一 样 。 调用 notifyChange() 方 法 , 相当 于 是 说 :“ 所 有 的 可 绑 定 属 
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性 都 变 了 ， 请 全 部 更 新 。” 调 用 notifyPropertyChanged(int) 方 法 ， 相 当 于 是 说 :“ 只 有 


getTitle() 方 法 的 值 有 变化 。” 
VAM 2:00 
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图 20-13 ”这 下 完美 了 




















和 次 运行 应 用 。 这 次 ， 无 论 怎么 深 上 深 下 ， 一切 都 没 问 题 了 。 
20.7 访问 assets 


本 章 的 工作 全 部 完成 了 。 下 一 章 还 会 继续 完善 BeatBox 应 用 ， 播 放 assets 声 音 资源 。 

继续 学 习 之 前 ， 一 起 花 点 时 间 深 入 探讨 一 下 assets 的 工作 原理 。 

Sound 对 象 定义 了 assets 文 件 路 径 。 尝 试 使 用 File 对 象 打开 资源 文件 是 行 不 通 的 。 正 确 的 方式 
是 使 用 AssetManager: 


String assetPath = sound.getAssetPath(); 
InputStream soundData = mAssets.open(assetPath); 


这 样 才能 得 到 标准 的 InputStream 数 据 流 。 随 后 ， 和 Java 中 的 其 他 InputStream 一 样 ， 该 怎 
么 用 就 怎么 用 。 

不 过 , 有 些 API 可 能 还 需要 FiLeDescriptor。( 下 一 章 的 SoundPoot 类 就 会 用 到 。) 这 也 好 办 ， 
改 用 AssetManager.openFd(String) 方 法 就 行 了 。 

String assetPath = Sound.getAssetPath() ; 

// AssetFileDescriptors are different from FileDescriptors, 

AssetFiLeDescriptor assetFd = mAssets.openFd(assetPath); 


// but you get can a regular FileDescriptor easily if you need to. 
FileDescriptor fd = assetFd.getFileDescriptor(); 
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20.8 深入 学 习 : 数据 绑 定 再 探 

数据 绑 定 可 学 的 还 有 很 多 ， 本 书 无 法 全 部 覆盖 。 不 过 ， 如 果 你 有 兴趣 ， 不 妨 再 多 了 解 一 下 。 
20.8.1 _ lambda 表达 式 

在 布局 文件 里 , 还 可 以 使 用 lambda 表 达 式 写 点 短 回调 。 以 下 是 一 些 简化 版 的 Javalambda 表 达 式 : 


<Button 
android:layout width="match parent" 
android:layout height="120dp" 
android:text="@{viewModel .title}" 
android:onClick="@{(view) -> viewModel.onButtonClick()}" 
tools:text="Sound name"/> 


和 Java 8 lambda 表 达 式 差不多 ， 上 述 表达 式 会 转 成 目标 接口 实现 ( 这 里 是 View.0nClick- 
Listener )。 和 Java 8 lambda 表 达 式 不 同 的 是 ,这 些 表达 式 的 语法 有 些 特殊 : 参数 必须 在 括号 里 ， 
最 右边 一 定 要 有 一 个 表达 式 。 

另外 ， 还 有 一 点 和 Java 8 lambda 表 达 式 不 同 : 如 果 用 不 到 ，lambda 参 数 可 以 不 写 。 所 以 ， 下 
面 这 个 写法 也 可 以 。 


android:onClick="@{() -> viewModeL.onButtonCLick()}" 
20.8.2 更 多 语法 糖 
数据 绑 定 还 有 一 些 方便 的 语法 可 用 。 最 方便 的 一 个 是 使 用 单 引 号 代替 双 引 号 : 


android:text="@{ Fite name: ”+ viewModel.title}" 

这 里 ，`File name: “和 "File name: "是 一 样 的 。 

绑 定 表 达 式 也 有 一 个 遇 nutLL 值 就 合并 的 操作 符 ; 

android:text="@{ “File name: ”+ ViewModetL.tittLe ?? ‘No filLe }" 

如 果 titte 是 nutL，?? 操 作 符 就 返回 "No fite'" 值 。 

此 外 ， 数 据 绑 定 还 有 nuttl 自 动 处 理 机 制 。 在 上 面 的 代码 中 ， 即 使 viewModel 有 null 值 ， 数 
据 绑 定 也 会 给 出 nuLL 值 判断 ( viewModetL.tittLe 子 表达 式 会 给 出 "nuLL" ), 保证 应 用 不 会 因为 这 
个 原因 而 崩 演 。 
































20.8.3 BindingAdapter 
数据 绑 定 默认 会 把 绑 定 表达 式 解读 为 属性 方法 调用 。 所 以 ， 以 下 代码 会 被 翻译 为 setText 
(String ) 方 法 调用 
android:text="Gf File name: ”+ viewModel .title ?7? ‘No filLe `}" 
然而 ， 这 还 不 算 什 么 。 有 时 候 ， 你 可 能 会 想 给 某 些 特别 属性 赋予 一 些 定 制 行 为 。 一 般 的 做 法 


是 写 一 个 BindingAdapter: 























O 
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public class BeatBoxBindingAdapter { 
@BindingAdapter("app:soundName") 
public static void bindAssetSound(Button button, String assetFileName) { 


} 
} 


很 简单 ， 在 项 目的 任何 类 里 创建 一 个 静态 类 ， 再 使 用 6BindingAdapter， 并 传人 想 绑 定 作 
为 参数 的 属性 名 即 可 。( 是 的 ， 这 就 可 以 了 。) 数据 绑 定 只 要 想 用 那个 属性 ， 它 就 会 调用 这 个 静 
态 方法 。 

对 于 标准 库 里 的 组 件 ,很 可 能 你 也 想 用 数据 绑 定 做 点 什么 。 实 际 上 ， 有 一 些 常见 的 操作 已 经 
定义 了 绑 定 adapter。 例 如 ，TextViewBindingAdapter 就 为 TextView 提 供 了 一 些 特 别 的 属性 操 
作 。 你 可 以 看 看 它们 的 源码 。 所 以 ， 若 想 自己 写 解决 方案 ， 不妨 先 按 Command+ShiftrO 
(CCtrl+Shift+O ) 搜 一 搜 ， 打 开 其 关联 的 绑 定 adapter 看 看 ， 也 许 已 经 有 你 想 要 的 了 。 


20.9 深入 学 习 : 为 何 使 用 assets 


事实 上 ，BeatBox 应 用 也 可 以 使 用 Android 资 源 处 理 。 资 源 可 以 存储 声音 文件 。 比 如 在 resAraw 
目录 下 保存 79_ long_scream.wav 文 件 后 ， 就 可 以 使 用 像 R. raw.79_long_scream 这 样 的 ID 取 到 它 。 
声音 文件 存储 为 资源 后 ,就 可 以 像 使 用 其 他 资源 那样 使 用 它们 了 。 例如 ， 可 以 根据 设备 的 不 同方 
位 、 语 言 以 及 系统 版 本 调用 不 同 的 声音 资源 。 

那么 为 何 还 要 选 assets 呢 ? 这 是 因为 ，BeatBox 应 用 要 用 到 很 多 声效 ， 总 共 大 约 20 多 个 声音 文 
件 。 可 以 想象 ， 如 果 使 用 Android 资 源 系统 一 个 个 去 处 理 ， 效 率 会 非常 低 。 要 是 这 些 文件 能 全 放 
在 一 个 目录 下 管理 就 好 了 ， 可 惜 资源 系统 不 允许 这 么 做 。 

资源 系统 做 不 到 的 , 就 是 assets 大 显 身手 的 地 方 。assets 可 以 看 作 随 应 用 打包 的 微型 文件 系统 ， 
支持 任意 层次 的 文件 目录 结构 。 因 为 这 个 优点 ，assets 常 用 来 加 载 大 量 图 片 和 声音 资源 ， 如 游戏 
这 样 的 应 用 。 










































































20.10 ”深入 学 习 : 什么 是 non-assets 


AssetManager 类 还 有 像 openNonAssetFd(...) 这 样 的 方法 。 想 不 通 吧 ，assets 专 属 类 为 什么 
要 关心 non-assets? 我 们 也 许 会 答 道 :“ 你 也 没 必 要 关心 这 事 !” 算 了 ， 你 就 当 从 未 听 说 过 它 好 了 。 

就 我 们 所 知 ， 还 真 找 不 到 使 用 它 的 理由 ， 所 以 不 学 习 它 的 理由 很 充分 。 

不 过 ， 既 然 你 花 钱 买 了 这 本 书 ， 下 面 就 简单 介绍 一 下 ， 博 君 一 笑 好 了 。 

前 面 说 过 ，Android 有 assets 和 resources 两 大 资源 系统 。resources 系 统 有 良好 的 检索 机 制 ， 但 
无 法 处 理 大 资源 。 这 些 大 资源 ， 如 声音 文件 和 图 像 文件 ， 通 常会 保存 在 assets 系 统 里 。 在 后 台 ， 
Android 就 是 使 用 openNonAsset 方 法 来 打开 它们 的 。 不 过 ， 这 样 的 方法 有 不 少 没 对 用 户 开放 。 

现在 了 解 了 吧 ! 有 机 会 用 到 它 吗 ? 永远 没有 。 










































































音频 播放 与 单元 测试 2 











MVVM 架 构 极 大 方便 了 一 项 关键 编程 工作 : 单元 测试 。 这 也 是 其 受 追 氛 的 另 一 个 原因 。 单 





























元 测试 是 指 编写 小 程序 去 验证 应 用 各 个 单元 的 独立 行为 。BeatBox 应 用 的 单元 是 Java 类 。 单 元 测 
试 就 是 测试 这 些 类 。 








BeatBox 的 音频 资源 文件 已 准备 就 绪 ， 我 们 在 本 章 学 习 如 何 播放 这 些 .wav 音 频 文 件 。 在 创建 








音频 播放 功能 并 整合 的 过 程 中 ， 还 会 对 SoundviewModet 的 功能 整合 做 单元 测试 。 





Android 的 大 部 分 音频 API 都 比较 低级 ， 不 易 掌 握 。 不 过 没关系 ， 对 于 BeatBox 应 用 ， 可 以 使 














用 SoundPoo1l 这 个 定制 版 实用 工具 。SoundPoo1l 能 加 载 一 批 声音 资源 到 内 存 中 ， 并 能 控制 同时 播 
放 的 音频 文件 的 个 数 。 所以， 就算 用 户 一 时 兴奋 ， 狂 按 各 个 按钮 播放 音频 ， 也 不 用 担心 会 搞 坏 应 
用 或 让 手机 掉 电 。 





准备 好 了 吗 ? 开始 吧 。 





21.1 创建 SoundPool 


首先 实现 音频 播放 功能 ， 这 需要 创建 一 个 SoundPoo1 对 象 ， 如 代码 清单 21-1 所 示 。 


代码 清单 21-1 创建 SoundPoo1l 对 象 ( BeatBox.java ) 


public class BeatBox { 
private static final String TAG = "BeatBox"; 


private static final String SOUNDS FOLDER = "sample sounds"; 
private static final int MAX _ SOUNDS = 5; 


private AssetManager mAssets 
private List<Sound> mSounds = new ArrayList<>(); 
private SoundPool mSoundPool; 


public BeatBox(Context context) { 
mAssets = context.getAssets(); 
// This old constructor is deprecated, but we need it for compatibility. 
mSoundPool = new SoundPool (MAX_ SOUNDS, AudioManager.STREAM MUSIC, 0); 
loadSounds (); 
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Lollipop 引 入 了 新 的 SoundPoot 创 建 方式 : 使 用 SoundPool.Builder。 不 过 , 为 了 兼容 API 19 
这 一 最 低级 别 ， 还 是 要 用 SoundPool (int，int，int) 这 个 老 构 造 方法 。 

第 一 个 参数 指定 同时 播放 多 少 个 音频 。 这 里 指定 了 5 个 。 已 经 播放 了 5 个 音频 时 ， 如果 尝试 再 
播 第 6 个 ，SoundPoot 会 停止 播放 原来 的 音频 。 

第 二 个 参数 确定 音频 流 类 型 。Android 有 很 多 不 同 的 音频 流 ， 它 们 都 有 各 自 独立 的 音量 控制 
选项 。 这 就 是 调 低 音乐 音量 ,， 闵 钟 音量 却 不 受 影响 的 原因 。 打 开 开 发 者 文档 ， 先 找到 
AudioManager 类 中 以 AUDI0 打 头 的 常量 ， 再 看 看 其 他 控制 选项 。STREAM_MUSIC 是 音乐 和 游戏 
常用 的 音量 控制 常量 。 


最 后 一 个 参数 指定 采样 率 转换 品质 。 人 参考 文 档 说 这 个 参数 不 起 作用 ， 所 以 这 里 传人 0。 

































































21.2 ”加 载 音频 文件 


接 下 来 使 用 SoundPoot 加 载 音频 文件 。 相 比 其 他 音频 播放 方法 ，SoundPoot 还 有 个 快速 响应 
的 优势 : 指令 刚 一 发 出 ， 它 就 立即 开始 播放 ， 一 点 都 不 拖 灌 。 

不 过 反应 快 也 要 付出 代价 ， 那 就 是 在 播放 前 必须 预先 加 载 音频 。SoundPoot 加 载 的 音频 文件 
都 有 自己 的 Integer 型 ID。 如 代码 清单 21-2 所 示 ， 在 Sound 类 中 添加 mSoundId 实 例 变量 ， 并 添加 
相应 的 getter 方 法 和 setter 方 法 管理 这 些 ID。 


























代码 清单 21-2 添加 mSoundId 实 例 变 量 ( Sound.java ) 


public class Sound { 
private String mAssetPath ; 
private String mName; 
private Integer mSoundId; 


public String getName() { 
return mName; 


} 


public Integer getSoundId() { 
return mSoundId; 


} 


public void setSoundId(Integer soundId) { 
mSoundId = soundId; 








} 
} 
注意 ，mSoundId 用 了 Integer 类 型 而 不 是 int。 这 样 ， 在 Sound 的 mSoundId 没 有 值 时 ， 可 以 
设置 其 为 nuLL 值 。 


现在 处 理 音频 加 载 。 在 BeatBox 中 添加 Load(Sound) 方 法 载 和 人 音频， 如 代码 清单 21-3 所 示 。 


代码 清单 21-3 ”加 载 音 频 ( BeatBox.java) 


private void loadSounds() { 
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} 


private void Load(Sound sound) throws I0Exception { 
AssetFiLeDescriptor afd = mAssets.openFd(sound.getAssetPath() ); 
int soundId = mSoundPooL.Load(afd，1) ; 
sound.setSoundId(soundId ) ; 





} 


public list<Sound> getSounds() { 
return mSounds; 














} 
} 
调用 mSoundPoo1. load(AssetFileDescriptor, int) ey edt 
为 了 方便 管理 、 重 播 或 印 载 音频 文件 , mSoundPoo1 .load( 方法 会 返回 一 个 int 型 ID。 这 实际 











就 是 存储 在 msoundId 中 的 ID 。 调 用 openFd(String) | 出 IOException，Load(Sound) 
方法 也 是 如 此 。 

现在 ， 在 BeatBox.LoadSounds () 方 法 中 ， 调 用 Load(Sound) 方 法 载 和 人 全 部 音频 文件 ， 如 代 
码 清 单 21-4 所 示 。 


代码 清单 21-4” 载 入 全 部 音频 文件 (BeatBoxjava ) 


private void LoadSounds() { 








for (String filename : SoundNames) { 

try { 
String assetPath = SOUNDS FOLDER + "/" + filename; 
Sound sound = new Sound(assetPath); 
load (sound); 
mSounds .add (sound); 

} catch (IOException ioe) { 
Log.e(TAG, "Could not Load sound " + filename, ioe); 


} 


运行 应 用 确认 音频 都 已 正确 加 载 。 否 则 ， 会 看 到 LogCat 中 的 红色 异常 日 志 。 





21.3 ”播放 音频 


最 后 一 步 是 播放 音频 。 在 BeatBox 中 添加 pLay(Sound) 方 法 。 
代码 清单 21-5 ”播放 音频 (BeatBox.java ) 


public BeatBox(Context context) { 
mAssets = context.getAssets(); 
// This old constructor is deprecated but needed for compatibility 
mSoundPool = new SoundPool (MAX SOUNDS, AudioManager.STREAM MUSIC, 0); 
loadSounds(); 
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} 


public void play(Sound sound) { 
Integer soundId = sound.getSoundId(); 
if (soundId == null) { 
return; 


} 
mSoundPool .play(soundId, 1.0f, 1.0f, 1, 0, 1.0f); 
} 


private void loadSounds() { 


播放 前 ， 要 检查 并 确保 soundId 不 是 nutl 值 。Sound 加 载 失 败 会 出 现 nut1l 值 的 情况 。 

检查 通过 后 ， 就 可 以 调用 SoundPootL.ptay(int，fLoat，fLoat，int，int，ftLoat) 方 法 播 
放 音 频 了 。 这 些 参数 依次 是 : 音频 ID、 左 音量 、 右 音量 、 优 先 级 ( 无效 )、 是 否 循环 以 及 播放 速 
率 。 我 们 需要 最 大 音量 和 常 速 播放 ， 所 以 传 入 值 1.06。 是 否 循环 参数 传人 ， 代 表 不 循环 。( 如 果 
想 无 限 循 环 ， 可 以 传人 -1。 相 信 这 会 异常 讨 人 厌 。) 
现在 ， 可 以 把 音频 播放 功能 整合 进 SoundviewModeL 了 。 不 过 ， 我 们 打算 先 做 单元 测试 再 整 
合 。 具 体 做 法 是 这 样 : 先 写 个 肯定 会 失败 的 单元 测试 ， 然 后 整合 ， 让 单元 测试 成 功 通过 。 






























































21.4 添加 测试 依赖 


要 编写 测试 代码 ， 首 先 需要 添加 两 个 测试 工具 : Mockito 和 Hamcrest。Mockito 是 一 个 方便 创 
建 虚拟 对 象 的 Java 框 架 。 有 了 虚拟 对 象 ， 就 可 以 单独 测试 SoundViewModel， 不 用 担心 会 因 代码 
关联 关系 测 到 其 他 对 象 。 

Hamecrest 是 个 规则 匹配 器 工具 库 。 匹 配器 可 以 方便 地 在 代码 里 模拟 匹配 条 件 。 如 果 不 能 按 预 
期 匹配 条 件 定 义 ， 测 试 就 通 不 过 。 这 可 以 验证 代码 是 否 按 预 期 工作 。 

有 这 两 个 依赖 库 就 可 以 做 单元 测试 了 ,现在 就 来 添加 。 右 键 单 击 app 模 块 ， 选择 Open Module 
Settings 菜 单项 。 选 择 弹出 界面 里 的 Dependencies 选 项 页 ， 然 后 点 击 + 按钮 弹出 选择 依赖 库 窗 口 ， 
输入 mockito 后 搜索 ， 如 图 21-1 所 示 。 


ER ) Choose Library Dependency 

































































org.mockito:mockito-core:2.2.1 
Enter terms for Maven Central search, or fully-qualified coordinates (e.g. com.google.code.gson:gson:2.2.4) 
org.mockito:mockito-core (org.mockito:mockito-core:2.2.1) 
org.mockito:mockito-all (org.mockito:mockito-all:2.0.2-beta) 

info.solidsoft.mockito:mockito-javag8 (info.solidsoft.mockito:mockito-java8:2.0.0-beta.5) 
com.google.code.maven-play-plugin.com.google.code.eamelink-mockito:mockito-all (com.google.code.maven-—... 
net.therore.spring.mockito:therore-spring-mockito (net.therore.spring.mockito:therore-spring-mockito:1.3.0) 
com.bluecatcode.mockito:mockito-1.10.19-extended (com.bluecatcode.mockito:mockito-1.10.19-extended:1.1... 
uk.co.webamoeba.mockito.collections:mockito-collections (uk.co.webamoeba.mockito.collections:mockito-coll.. 
uk.co.webamoeba.mockito.collections:mockito-collections-samples (uk.co.webamoeba.mockito.collections:moc... 


ca | TI 





图 21-1 导入 Mockito 


选择 org.mockito:mockito-core 依 赖 库 ， 点 击 OK 按 钮 完成 添加 。 重 复 上 述 步 又 ， 搜 索 
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hamcrest-junit 并 选择 org.hamcrest:hamcrest-junit 完 成 对 Hamcrest 依 赖 库 的 添加 。 

完成 之 后 ， 就 可 以 在 依赖 清单 里 看 到 了 。 注 意 ， 这 两 个 依赖 项 右边 都 有 下 拉 箭 头 。 点 击 它 ， 
可 选择 不 同 的 依赖 项 作用 范围 。 由 于 只 人 允许 指定 整合 测试 范围 ， 因 此 需要 手动 修改 build.gradle 
文件 。 

打开 build.gradle 文 件 ， 把 依赖 项 作用 范围 从 compiLe 改 为 testCompite， 如 代码 清单 21-6 所 示 。 


代码 清单 21-6 ”修改 依赖 项 作用 范围 ( app/build.gradle ) 


dependencies { 
compile fileTree(include: ['*.jar'], dir: 'libs') 
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', { 
exclude group: 'com.android.support', module: "Support-annotations' 














}) 

compile 'com.android.support:appcompat-v7:24.2.0" 
testCompile 'junit:junit:4.12' 

compile 'com.android.support:recyclerview-v7:24.2.0' 
cempilte testCompile 'org.mockito:mockito-core:2.2.1' 
compilte testCompile 'org.hamcrest:hamcrest-junit:2.0.0.0' 


testCompile 作 用 范围 表示 ， 这 两 个 依赖 项 只 需 包括 在 应 用 的 测试 编译 里 。 这 样 就 能 避免 在 
APK 包 里 撒 带 上 无 用 代码 库 。 





21.5 创建 测试 类 


写 单元 测试 最 方便 的 方式 是 使 用 测试 框架 。 使 用 测试 框架 可 以 集中 编写 和 运行 测试 案例 , 并 
支持 在 Android Studio 里 看 到 测试 结 

JUnit 是 最 常用 的 Android 单 元 测试 框架 ， 能 和 Android Studio 无 缝 整合 。 要 用 它 测试 ， 首 先 要 
创建 一 个 用 作 JUnit 测 试 的 测试 类 。 打 开 SoundViewModel.java 文 件 ， 使 用 Command+Shift+T 
( Ctrlt+Shift+T ) 组 合 键 。Android Studio 会 尝试 寻找 这 个 类 关联 的 测试 类 。 如 果 找 不 到 ， 它 就 会 提 
示 新 建 ， 如 图 21-2 所 示 。 


























public class SoundViewModel extends Base0bservabLe { 
private Sound Choose Test for SoundViewModel (0 found) 冷 


private BeatBo gr eg me ra 


F public SoundViewModel(BeatBox beatBox) { mBeatBox = beatBox; } 


@Bindable 
F public String getTitle() { return mSound.getName(); } 


上 public Sound getSound() { return mSound; } 
图 21-2 ”尝试 打开 测试 类 


选择 Create New Test... 创 建 一 个 新 测试 类 。 测 试 库 选 择 JUnit4， 勾 选 setUp/@Before， 其 他 保 
持 默 认 设 置 ， 如 图 21-3 所 示 。 
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中 0 














oe Create Test 

Testing library: JUnit4 
Class name: SoundViewModelTest 
Superclass: 
Destination package: com.biqnerdranch.android.beatbox 
Generate: setUp/@Before 

tearDown/@After 
Generate test methods for: Show inherited methods 


Member 
加 说 getTitle0:String 
回 癌 ”getSound0:Sound 
国 虽 。 setSound(sound:Sound):void 


? cancel CI 








图 21-3 ”创建 测试 类 
点 击 OK 按 钮 ， 进 入 下 一 个 对 话 框 。 





最 后 一 步 是 选择 创建 哪 种 测试 类 , 或 者 说 选择 哪个 测试 目录 存放 测试 类 ( androidTest 和 test )。 





在 androidTest 目 录 下 的 都 是 整合 测试 类 。 整合 测试 可 以 运行 在 设备 或 虚拟 设备 上 。 这 样 做 有 优点 
可 以 在 运行 时 动态 测试 应 用 行为 。 但 也 有 和 缺点: 需要 编译 打包 为 APK 在 设备 上 运行 ， 
( 详 见 21.12 节 。) 

















J 


浪费 资源 。 


在 test 目 录 下 的 是 单元 测试 类 。 单元 测试 运行 在 本 地 开发 机 上 , 可 以 脱离 Android 运 行 时 环境 ， 


因此 速度 会 快 很 多 。 








单元 测试 的 规模 最 小 : 测试 单个 类 。 所 以 ,单元 测试 不 需要 运行 整个 应 用 或 支持 设备 ， 可 以 


号 和 


© © Choose Destination Directory 


Directory Structure Choose By Neighbor Class 
了 
app 
口 .../app/src/androidTest/java/com/bignerdranch/android/be: 


/app/src/test/java/com/bignerdranch/android/beatbox 


cance | LB 
图 21-4 ”选择 test 目 录 





响 手 头 工 作 , 快速 反复 地 执行 。 考 虑 到 这 个 因素 ,我们 选择 test 目 录 存 放 测 试 类 ( 如 图 21-4 )， 
最 后 点 击 OK 按钮 完成 。 
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21.6 ”实现 测试 类 





现在 来 实现 SoundviewModet 测 试 类 。 测 试 框架 创建 的 模板 类 只 有 一 个 setUp() 方 法 ， 如 代 
码 清单 21-7 所 示 。 


代码 清单 21-7 空 测 斌 类 ( SoundViewModelTest.java ) 


public class SoundViewModelTest { 
GBefore 
public void setUp() throws Exception { 





} 
} 


(这 个 测试 类 位 于 app 模 块 下 的 test 目 录 下 。) 

和 大 多 数 对 象 一 样 , 测试 类 也 需要 创建 对 象 实例 以 及 它 依 赖 的 其 他 对 象 。 为 了 避免 为 每 一 个 
测试 类 写 重复 代码 ，JUnit 提 供 了 @Before 这 个 注解 。 以 @Before 注 解 的 包含 公共 代码 的 方法 会 在 
所 有 测试 之 前 运行 一 次 。 按 照 约 定 ， 所 有 单元 测试 类 都 要 有 以 @Before 注 解 的 setUp() 方 法 。 


使 用 虚拟 依赖 项 


在 setUp() 方 法 里 ， 我 们 会 创建 一 个 SoundViewModel 实 例 用 来 测试 。 这 需要 BeatBox 实 例 ， 
因为 SoundViewModel 需 要 BeatBox 作 为 构造 参数 。 

在 实际 应 用 中 ， 当 然 会 创建 BeatBox 实 例 。 怎 么 创建 ? 像 下 面 这 样 : 

SoundViewModel viewModel = new SoundViewModel (new BeatBox()); 

如 果 在 单元 测试 中 也 这 样 做 ， 会 有 一 个 问题 : 如 果 BeatBox 出 了 问题 ， 很 明显 ， 用 到 它 的 测 
试 代码 都 会 出 错 。 
解决 办 法 很 简单 : 使 用 虚拟 BeatBox。 虚 拟 对 象 会 继承 BeatBox， 有 同样 的 方法 ， 但 这 些 方 
法 喻 事 都 不 干 。 这 样 ， 依 赖 BeatBox 的 SoundViewModel 测 试 就 不 会 有 问题 了 。 

要 用 Mockito 创 建 虚拟 对 象 ， 需 要 传人 要 虚拟 的 类 ， 调 用 mock (Class) 静 态 方 法 。 创 建 一 个 
虚拟 BeatBox 对 象 并 存 人 mBeatBox 变 量 ， 如 代码 清单 21-8 所 示 。 


代码 清单 21-8 ”创建 虚拟 BeatBox 对 象 ( SoundViewModelTest.java ) 


public class SoundViewModelTest { 
private BeatBox mBeatBox; 





























GBefore 
public void setUp() throws Exception { 
mBeatBox = mock(BeatBox.class); 
} 
} 


使 用 mock(CtLass ) 方 法 需要 导入 支持 包 , 这 和 其 他 类 引用 没什么 两 样 。mock(CtLass ) 方 法 会 
自动 创建 一 个 虚拟 版 本 的 BeatBox。 这 确实 很 方便 。 
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有 了 虚拟 依赖 对 象 ， 现 在 来 完成 SoundViewModel 测 试 类 。 创 建 一 个 SoundViewModel 和 一 个 
Sound 备 用 ( Sound 是 简单 的 数据 对 象 ， 不 容易 出 问题 ， 这 里 就 虚拟 它 了 )， 如 代码 清单 21-9 所 示 。 


代码 清单 21-9 ”创建 SoundViewModel 测 试 对 象 ( SoundViewModelTest.java ) 


public class SoundViewModelTest { 
private BeatBox mBeatBox; 
private Sound mSound; 
private SoundViewModel mSubject; 


GBefore 

public void setUp() throws Exception { 
mBeatBox = mock(BeatBox.class); 
mSound = new Sound("assetPath"); 
mSubject = new SoundViewModel (mBeatBox); 
mSubject. setSound (mSound); 


} 
注意 ， 在 本 书 的 其 他 地 方 ， 声 明 SoundViewModel 类 型 变量 时 ,命名 一 般 是 mSoundView- 
Model。 这 里 ,我们 用 了 mSubject。 这 是 一 种 习惯 约定 ， 这 样 做 的 原因 有 两 点 : 
口 很 清楚 就 知道 ，mSubject 是 要 测试 的 对 象 ( 与 其 他 对 象 区 别 开 来 ); 
口 如 果 SoundViewModel 里 有 任何 方法 要 移 到 其 他 类 ， 比 如 BeatBoxSoundViewModel， 那 
么 测试 方法 可 以 直接 复制 过 去 ， 省 了 mSoundViewModel 到 mBeatBoxSoundViewModel 重 
命名 的 麻烦 。 




































































21.7 ”编写 测试 方法 


setUp() 支 持 方法 完成 了 , 现在 可 以 写 测试 代码 了 。 实际 上 , 就 是 在 测试 类 里 写 一 个 以 GTest 
注解 的 测试 方法 。 

如 代码 清单 21-10 所 示 ， 首 先 写 一 个 方法 ， 断 定 SoundViewModel 里 的 getTitle() 属 性 和 
Sound 里 的 getName() 属 性 是 有 关系 的 。 














代码 清单 21-10 ”测试 标题 属性 ( SoundViewModelTest.java ) 


GBefore 

public void setUp() throws Exception { 
mBeatBox = mock(BeatBox.class); 
mSound = new Sound("assetPath"); 
mSubject = new SoundViewModel (mBeatBox); 
mSubject.setSound (mSound); 


} 


@Test 

public void exposesSoundNameAsTitle() { 
assertThat(mSubject.getTitle(), is(mSound.getName())); 

} 
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注意 , 窗口 里 有 两 个 方法 会 变 红 :assertThat(...) 方 法 和 is(...) 方 法 ,在 assertThat(...) 
方法 上 使 用 Option+Retum ( AlttEnter ) 组 合 键 ， ， 然 后 选 Static import method... ， 然 后 选 
hamcrest-core-L.3 库 里 的 MatcherAssert.assertThat(.,.) 方 法 。 以 同样 方式 ， 选 hamcrest-core- 
1.3 库 里 的 Is .is 方法 。 

这 个 测试 方法 使 用 了 Hamcrest 匹 配器 的 is(... ) 方 法 和 JUnit 的 assertThat(.,.) 方 法 ,方法 
体 里 的 代码 很 直 白 : 断定 测 试 对 象 获取 标题 方法 和 sound 的 获取 文件 名 方法 返 回 相 同 的 值 。 如 果 
不 同 ， 单 元 测试 失败 。 

为 了 运行 测试 , 右键 点 击 app/java/com.bignerdranch.android.beatbox (test), 然后 选择 Run 'Tests 
in "beatbox"。 随 后 ， 一 个 结果 窗口 弹出 ， 如 图 21-5 所 示 。 
































All 2 tests passed - 654ms 








> @@ 刘 :| 此 上 全 量 ， 
Bd @All Tests Passed 654ms /Library/Java/JavaVirtualMachines/jdk1.8.0_05.jdk/Contents/Home/bin/java ... 





2: Favorites 


Process finished with exit code 9 


此 图 


上 
日 


公吨 罗 册 4 


po ploJpuy Bs 


idVariants 站 
> »%: 


外 2 EventLog ” 国 Gradle Console 


间 0:Messages 国 Terminal ”网 9: Version Control ”党 6Android Monitor 天 Ri 3Topo 
26:15 LF*? UTF-8$ Context' <nocontext> “由 且 @ 


Tests Passed: 2 passed (10 minutes ago) 














图 21-5 ”测试 过 关 
测试 结果 窗口 默认 只 会 显示 失败 的 测试 。 所 以 ， 你 知道 ， 测 试 通过 了 。 


测试 对 象 交 互 

刚才 做 了 测试 热身 , 现在 处 理 关键 任务 : 整合 SoundViewModel 和 BeatBox.play(Sound) 方 
法 。 实 践 中 , 通常 的 做 法 是 ,在 写 新 方法 之 前 ， 先 写 一 个 测试 验证 这 个 方法 的 预期 结果 。 我 们 需 
要 在 SoundViewModel 类 里 写 onButtonClicked() 方 法 去 调用 BeatBox.play(Sound) 方 法 ,如 代 
码 清单 21-11 所 示 ， 写 一 个 测试 方法 调用 onButtonCLicked () 方 法 。 






































代码 清单 21-11 测试 onButtonCLicked () 方 法 (SoundViewModelTestjava ) 


GTest 
public void exposesSoundNameAsTitle() { 
assertThat(mSubject.getTitle(), is(mSound.getName())); 


} 


@Test 
public void callsBeatBoxPlayOnButtonClicked() { 
mSubject .onButtonClicked(); 


E 意 ， 这 个 方法 还 没 写 ， 所 以 它 是 红色 的 。 如 代码 清单 21-12 所 示 ， 将 光标 移 到 它 身 上 ， 按 


人 心 \» 


Option+Return ( Alt+Enter ) 组 合 键 ， 然 后 选 Create method 'onButtonClicked' 创 建 这 个 方法 。 
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代码 清单 21-12 ”创建 onButtonCLicked() 方 法 (SoundViewModeljava ) 


public void setSound(Sound sound) { 
mSound = sound; 
notifyChange(); 

} 


public void onButtonClicked() { 














} 
} 
先 不 管 这 个 空 方法 , 按 Command+Shift+T( Ctrl+Shift+T ) 组 合 键 , 回 到 SoundViewModelTestt 
测试 类 。 








单元 测试 方法 会 调用 这 个 方法 ， 而 且 ， 也 应 验证 这 个 方法 的 实际 作用 : 调用 BeatBox. 
play (Sound) 方 法 。 这 种 繁琐 的 事 就 交 给 Mockito 吧 1! 对 于 每 次 调用 ， 所 有 的 Mockito 虚 拟 对 象 都 
能 自我 跟踪 管理 哪些 方法 调用 了 ， 以 及 都 传人 了 哪些 参数 。 

如 代码 清单 21-13 所 示 ， 调 用 verify(0bject) 方 法 ,确认 onButtonClicked() 方 法 调用 了 
BeatBox.play (Sound) 方 法 。 








代码 清单 21-13 ”验证 BeatBox.play (Sound) 方 法 是 否 调 用 ( SoundViewModelTest.java ) 


assertThat(mSubject.getTitle(), is(mSound.getName())); 
} 


@Test 
public void callsBeatBoxPlayOnButtonClicked() { 
mSubject.onButtonClicked(); 
verify(mBeatBox) .play (mSound); 
} 
类 似 于 前 面 的 AlLertDialog.Builder 类 , verify(0bject) 使 用 了 流 接口 , 分开 写 就 像 这 样 : 





verify (mBeatBox); 
mBeatBox.play (mSound); 


调用 verify (mBeatBox) 方 法 就 是 说 :“ 我 要 验证 mBeatBox 对 象 的 某 个 方法 是 否 调 用 了 。” 紧 
跟 的 mBeatBox.play (mSound) 方 法 是 说 :“ 验 证 这 个 方法 是 这 样 调用 的 。” 所 以 , 合 起 来 就 是 说 : 
“验证 以 mSound 作 为 参数 ， 调 用 了 mBeatBox 对 象 的 play(... ) 方 法 。” 

SoundViewModel.onButtonClicked() 是 个 空 方 法 , 所 以 , 什么 也 没 发 生 。 这 意味 着 测试 应 
该 会 失败 。 因 为 是 先 写 测试 ， 所 以 这 不 是 问题 。 如 果 测 试 不 失败 ， 那 说 明 哈 也 没 测 到 。 

运行 测试 看 结果 。( 可 以 按 上 述 步骤 运行 测试 ， 也 可 以 使 用 Command+R ( Ctrl+R ) 快捷 键 重 
复 上 一 次 Run 命 令 。) 运行 结果 如 图 21-6 所 示 。 
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Run: | 号 app beatbox in app 次 " 土 


> @ 宣 : EE 3 tests done: 1 failed - 721ms 











时 
所 站 Wy <default package> 721ms| /Library/Java/JavaVirtualMachines/idk1.8.0 905,ijdk/Contents/Home/bin/java ... 
§ 由 packag: 全 
E > @soundviewModelTest 721ms 
Ai 国 党 
太 Wanted but not invoked' =p 
加 beatBox. play( 3 
图 | i com,bignerdranch,android,beatbox,.Sound6@635eaaf1 [Ee 前 
mn -> at com.bignerdranch.android.beatbox.SoundViewModelTest.callsBeatBoxPlayOnButtonClicked(soundViewModelTest, java:34) 局 3 
ee Actually, there were zero interactions with this mock, 亩 & 
三 
加 从 Wanted but not invoked: 未 
各 beatBox,ptay( 多 
2 com.bianerdranch,.android, beatbox, Sounde635eaaf1l 
加 0:Messages ”图 Terminal 团 9:VersionControl ”党 6:Android Monitor 上 了 恬 &RUn STODO 多 > EventLog ” 国 Gradle Console 
. 贺 Tests Failed: 2 passed, 1 failed (moments ago) 1:1 LF$ UTF-8$ Context <no context> ”了 县 





图 21-6 ”测试 失败 输出 
测试 结果 表明 ， 测 试 方法 要 调用 mBeatBox.play (mSound)， 但 没 成 功 : 


Wanted but not invoked: 
beatBox.play( 
com.bignerdranch.android.beatbox.Sound@64cd705f 
); 
-> at ...callsBeatBoxPlayOnButtonClicked(SoundViewModelTest.java:28) 
Actually, there were zero interactions with this mock. 


这 实质 上 是 说 ， 和 assertThat(...) 方 法 一 样 ，verify(0bject) 做 出 某 个 断定 ,但 断定 无 
效 ， 测 试 失 败 并 给 出 问题 原因 日 志 。 
如 代码 清单 21-14 所 示 ， 实 现 onButtonClicked() 方 法 ， 让 测试 符合 预期 。 

















代码 清单 21-14 ”实现 onButtonClicked() 方 法 (SoundViewModel.java ) 


public void setSound(Sound sound) { 
mSound = sound; 
notifyChange(); 

} 


public void onButtonClicked() { 
mBeatBox.play (mSound); 
} 
} 


再 次 运行 测试 。 如 图 21-7 所 示 ， 这 次 一 路 绿灯 ， 测 试 顺利 通过 。 














Run: app beatbox inapp 准 " 上 上 
由 > @ 国 加 后 三 半 : 个 4， All 3 tests passed - 880ms 
5 | 隐 国 AllTests Passed 880ms /Library/Java/JavaVirtuaLMachines/jdk1.8.9_95.jdk/Contents/Home/bin/java ... 个 
Ss 
高 
六 | 图 Process finished with exit code 9 + 
友 | 加 又 
| 国 间 
> 
i 图 al 
3 全 
二 | 
昌 从 和 
加 全 
加 0: Messages Terminal ”图 9:Version Control ”党 6:Android Monitor 由 请 有 Rn 9 ToDO 晤 z EventLog ” 国 Gradle Console 
国 Tests Passed: 3 passed (moments ago) 11 LFs UTF-8; Context: <nocontext> 了 般 怕 @ 

















图 21-7 ”测试 全 部 过 关 
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21.8 ”数据 绑 定 回调 


按钮 要 响应 事件 还 差 最 后 一 步 : 关联 按钮 对 象 和 onButtonCLicked( ) 方 法 。 

和 前 面 使 用 数据 绑 定 关联 数据 和 UI 一 样 , 你 也 可 以 使 用 lambda 表 达 式 ,让 数据 绑 定 帮忙 关联 
按钮 和 点 击 监听 器 (如果 忘 了 ， 请 参见 20.8.1 节 )。 

如 代码 清单 21-1$ 所 示 ， 在 布局 文件 里 ， 添 加 数据 绑 定 lambda 表 达 式 ， 让 按钮 对 象 和 
onButtonClicked() 方 法 关联 起 来 。 


代码 清单 21-15 ”关联 按钮 ( list item sound.xml ) 
<Button 
android:layout width="match parent" 
android:layout height="120dp" 
android:onClick="@{() -> viewModel .onButtonClicked()}" 
android:text="@{viewModel .title}" 
tools:text="Sound name"/> 
现在 ， 如 果 运 行 应 用 ,按钮 就 能 播放 声音 。 然 而 ， 如 果 你 尝试 使 用 绿色 的 运行 按钮 ， 测试 又 
运行 了 。 这 是 因为 右键 点 击 运 行 测 试 修改 了 运行 配置 。 这 个 配置 决定 点 击 绿 色 按 钮 之 后 , Android 
Studio 该 运行 什么 。 
如 图 21-8 所 示 ， 为 了 运行 BeatBox 应 用 ， 点 击 Run 按 钮 旁边 的 配置 选择 器 ， 切 换 至 app 运 行 
配置 。 



























































人 | 四 beatboxinappv| 苔 养 必 攻 所 国 : 凤 ; 
四 By Edit Configurations... 
) 党 辕 Save 'beatbox in app' Configuration atBox .java 





Fa 忆 
beatbox in app fore; 





amporc vrygrJurrerreSt; 


import static org.hamcrest.M 


limport static org.ijunit.Assel 


图 21-8 ”切换 运行 配置 
运行 BeatBox 应 用 ， 点 击 按钮 。 你 会 听 到 各 种 吓人 的 喊叫 声 。 不 要 害怕 ， 前 面 说 过 ， 这 个 应 

用 就 是 用 来 吓人 的 。 

21.9 释放 音频 


BeatBox 应 用 可 用 了 ,但 别 忘 了 做 善后 工作 。 音 频 播 放 完 毕 ， 应 调用 SoundPool .release() 
方法 释放 SoundPool。 如 代码 清单 21-16 所 示 ， 添 加 BeatBox.release() 清 理 方法 。 


bs 




















代码 清单 21-16 释放 SoundPool ( BeatBox.java) 


public class BeatBox { 
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public void play(Sound sound) { 


} 


public void release() { 
mSoundPool .release(); 


} 
ce 
同样 ， 在 BeatBoxFragment 中 ， 也 完成 释放 ， 如 代码 清单 21-17 所 示 。 


代码 清单 21-17 释放 BeatBox (BeatBoxFragment.java ) 
public class BeatBoxFragment extends Fragment { 
@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 


Bundle savedInstanceState) { 


} 


@Override 

public void onDestroy() { 
super.onDestroy(); 
mBeatBox. release(); 


} 


再 次 运行 应 用 ,确认 添加 release() 方 法 后 ， 应 用 工作 正常 。 尝 试播 放 一 长 段 声 音 ， 同 时 旋 
转 设备 或 点 按 后 退 键 ， 声 音 播放 应 该 会 停止。 


21.10 设备 旋转 和 对 象 保存 


处 理 完 资源 释放 ， 再 来 看 一 个 经 典 的 设备 旋转 问题 。 播 放 69_ohm-loko 这 个 音频 ， 然 后 旋转 
设备 ， 声 音 夏 然而 止 。( 如 果 没 有 ， 请 确认 已 实现 onDestroy() 方 法 ， 并 重新 编译 和 运行 应 用 。) 

下 面 分 析 一 下 这 个 问题 : 设备 旋转 时 ，BeatBoxActivity 随 即 被 销毁 。 与 此 同时 ， 
FragmentManager 也 会 销毁 BeatBoxFragment 。 在 销毁 过 程 中 , 它 会 逐一 调用 BeatBoxFragment 
的 生命 周期 方法 onPause() 、onStop() 和 onDestroy()。 在 BeatBoxFragment .onDestroy () 方 
法 中 ，BeatBox. reLease( ) 方 法 会 被 调用 。 这 会 释放 SoundPooL， 音 频 播放 自然 也 就 停止 了 。 

前 面 ， 我 们 遇 到 过 Activity 和 Fragment 因 设备 旋转 而 被 销毁 的 问题 。 当 时 使 用 onSsave- 
InstanceState(Bundle) 方 法 解决 了 问题 。 然 而 ， 老 办 法 在 这 里 行 不 通 ， 因 为 需要 首先 保存 数 
据 ， 然 后 再 使 用 Bundle 中 的 Parcelable 恢 复数 据 。 

类 似 于 Serializable，Parcelable 是 一 个 把 对 象 以 字 节 流 的 方式 保存 的 API。 对 于 可 保存 
对 象 ， 可 以 让 它 实现 Parcelable 接 口 。 在 Java 世 界 ， 要 保存 对 象 ， 要 么 将 其 放 入 Bundle 中 ,要 
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么 实现 SeriaLizabtLe 接 口 或 者 ParceLabtLe 接 口 。 无 论 采 用 哪 种 方式 , 对 象 首 先 要 是 可 保存 对 象 。 

怎么 理解 可 保存 呢 ? 举 个 例子 你 就 明白 了 。 你 和 朋友 在 看 电视 节目 。 什 么 频道 、 音 量 大 小 ， 
甚至 是 电视 型 号 ， 你 都 可 以 记 下 来 。 如 此 一 来 ， 就 算 发 生火 灾 或 停电 这 样 的 事情 ， 等 一 切 恢复 正 
常 ， 看 看 记 下 的 信息 ， 你 依然 能 接着 看 原来 的 电视 节目 。 

显然 ， 当 前 所 看 的 电视 节目 的 配置 是 可 保存 的 ， 而 观看 节目 的 那 段 时 间 却 无 法 保存 : 一 旦 发 
生火 灾 或 停电 ， 其 间 那 段 时 光 就 流逝 掉 了 。 就 算 恢 复 观 看 ， 流 逝 掉 的 那 段 时 光 再 也 找 不 回来 了 。 
所 以 ， 什 么 能 保存 ， 什 么 不 能 保存 ， 再 清楚 不 过 了 。 

BeatBox 的 某 些 部 分 可 以 保存 ， 例 如 ，Sound 类 中 的 一 切 都 可 以 保存 ;而 SoundPoo1 就 无 法 
保存 了 。 虽 然 可 以 新 建 包 含 同样 音频 文件 的 soundPooL， 甚 至 能 从 音频 播放 中 断 处 继续 ， 你 还 是 
会 体验 到 被 打 断 的 滋味 。 这 是 改变 不 了 的 事实 。 所 以 说 ，SoundPool 是 无 法 保存 的 。 

不 可 保存 性 有 向 外 传递 的 倾向 。 如果 一 个 对 和 象 重度 依赖 男 一 个 不 可 保存 的 对 象 , 那么 这 个 对 
象 很 可 能 也 无 法 保存 。BeatBox 和 SoundPool 就 是 这 样 的 一 对 。SoundPool 要 依靠 BeatBox 播 放 
音频 。 基 于 这 个 事实 ， 可 以 证 明 BeatBox 也 是 无 法 保存 的 。( 抱歉 。) 

普通 的 savedInstanceState 机 制 只 适用 于 可 保存 的 对 象 数 据 ， 但 BeatBox 不 可 保存 。 在 
Activity 创 建 和 销毁 时 ，BeatBox 实 例 需 要 持续 可 用 。 

这 个 难题 该 怎么 解决 呢 ? 






































































































































21.10.1 保留 fragment 


告诉 你 一 个 好 消息 : 为 了 应 对 设备 配置 变化 ，fragment 有 一 个 特殊 方法 可 确保 BeatBox 实 例 
不 被 销毁 ， 这 个 方法 就 是 retainInstance。 禾 盖 BeatBoxFragment .onCreate(...) 方 法 并 设 
置 fagment 的 属性 值 ， 如 代码 清单 21-18 所 示 。 





























代码 清单 21-18 调用 setRetainInstance(true) (BeatBoxFragment.java ) 


public static BeatBoxFragment newInstance() { 
return new BeatBoxFragment(); 


} 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setRetainInstance(true); 


mBeatBox = new BeatBox(getActivity()); 
和 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


fragment 的 retainInstance 属 性 值 默认 为 faLse， 这 表明 其 不 会 被 保留 。 因 此 ,设备 旋转 时 
fragment 会 随 托管 activity 一 起 被 销毁 并 重建 。 调 用 setRetainInstance(true) 方 法 可 保留 
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fragment。 已 保留 的 fragment 不 会 随 activity 一 起 被 销毁 。 相 反 ， 它 会 一 直 保 留 ， 并 在 需要 时 原封 
不 动 地 转 给 新 的 activity。 

对 于 已 保留 的 fagment 实 例 ， 其 全 部 实例 变量 ( 如 mBeatBox ) 的 值 也 会 保持 不 变 ， 因 此 可 放 
心 继续 使 用 。 

运行 BeatBox 应 用 。 播 放 69_ohm-loko 声 音 文件 ， 然 后 旋转 设备 ， 确 认 音 频 播放 不 受 影响 。 














21.10.2 ”设备 旋转 和 已 保留 的 fragment 


解决 了 问题 之 后 ， 我 们 来 看 看 保留 fagment 的 工作 原理 。fragment 之 所 以 能 保留 ， 是 因为 这 
样 一 个 事实 : 可 以 销毁 和 重建 fagment 的 视图 ， 但 fragment 自身 可 以 不 被 销毁 。 

设备 配置 发 和 后 改变 时 ，FragmentManager 首 先 销毁 队列 中 fragment 的 视图 。 在 设备 配置 改变 
时 ， 总 是 销毁 与 重建 fagment 与 activity 的 视图 ， 这 都 是 基于 同样 的 理由 : 新 的 配置 可 能 需要 新 的 
资源 来 匹配 ; 当 有 更 合适 的 资源 可 用 时 ， 则 应 重建 视图 。 

紧 接 着 ，FragmentManager 检 查 每 个 fragment 的 retainInstance 属 性 值 。 如 果 属 性 值 为 
false (初始 默认 值 )，FragmentManager 会 立即 销毁 该 fagment 实 例 。 随 后 ， 为 了 适应 新 的 设备 
配置 ， 新 activity 的 新 FragmentManager 会 创建 一 个 新 的 ffagment 及 其 视图 ， 如 图 21-9 所 示 。 



















































































旋转 前 


BeatBoxActivity 


FragmentManager 


新 
FragmentManager 





新 
BeatBoxFragment 





BeatBoxFragment 
| 新 
RecyclerView RecyclerView 








图 21-9 设备 旋转 前 后 ( UI fragment 默 认 不 保留 ) 

如 果 属 性 值 为 true， 则 该 fagment 的 视图 立即 被 销毁 ， 但 fragment 本 身 不 会 被 销毁 。 为 了 适 
应 新 的 设备 配置 ， 新 activity 创 建 后 ， 新 FragmentManager 会 找到 已 保留 的 fragment， 并 重新 创建 
它 的 视图 ， 如 图 21-10 所 示 。 
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虽然 已 保留 的 fagment 没 有 被 销毁 ， 但 它 已 脱离 消亡 中 的 activity 并 处 于 保留 状态 。 尽 管 此 时 














的 ffagment 还 在 ， 但 已 没有 任何 activity 托 管 它 ， 如 图 21-11 所 示 。 





旋转 前 旋转 时 


BeatBoxActivity 







新 


FragmentManager 









FragmentManager 





FragmentManager 
BeatBoxFragment 
RecyclerView 


BeatBoxFragment 









图 21-10 ”设备 旋转 与 已 保留 的 UI fragment 


onAttach() onAttach() 
AN 
onCreatel...) 


onDetach() onDetach() 


onCreateView0 
onDestroy0 
已 创建 


onActivityCreated() onDestroyView() 








已 停止 


onStart( onStop0 


onResume0l onPause() 














图 21-11 ”fragment 的 生命 周 划 











旋转 后 
新 
BeatBoxActivity 
新 
FragmentManager 


BeatBoxFragment 
新 
RecyclerView 


21.12 深入 学 习 : Espresso 与 整合 测试 ”351 





必须 同时 满足 以 下 两 个 条 件 ，fragment 才 能 进入 保留 状态 : 
口 已 调用 了 fragment 的 setRetainInstance(true) 方 法 ; 
口 因 设备 配置 改变 (通常 为 设备 旋转 )， 托 管 activity 正 在 被 销毁 。 
fragment 只 能 保留 非常 短 的 时 间 ， 即 从 fragment 脱 离 旧 activity 到 重新 附加 给 快速 新 建 的 
activity 之 间 的 一 段 时 间 。 


21.11 深入 学 习 : 是 否 保留 fragment 


保留 fagment 可 以 说 是 Android 的 一 处 巧妙 设计 , 不 是 吗 ? 没 错 ! 这 似乎 解决 了 因 设 备 旋转 而 
销毁 activity 和 fragment 所 导致 的 全 部 问题 。 现 在 ， 如 果 设 备 配置 有 变 ， 可 以 创建 全 新 视图 获取 最 
合适 的 资源 ， 也 可 以 轻松 保留 原 有 数据 及 对 象 。 

你 可 能 会 疑惑 : 为 什么 不 保留 所 有 fragment? 为 什么 fragment 的 retainInstance 默 认 属 性 值 
不 是 true? 这 是 因为 ， 除 非 万 不 得 已 ， 最 好 不 要 使 用 这 种 机 制 。 下 面 给 出 理由 。 

首先 ， 相 比 非 保留 fragment， 已 保留 fragment 用 起 来 更 复杂 。 一 旦 出 现 问题 ， 问 题 排 查 非 常 
耗 时 。 既 然 它 会 让 程序 变 得 复杂 ， 能 不 用 就 不 用 吧 ，。 

其 次 , fragment 在 使 用 保存 实例 状态 的 方式 处 理 设备 旋转 时 , 也 能 够 应 对 所 有 生命 周期 场景 ; 
但 保留 的 fragment 只 能 应 付 activity 因 设备 旋转 而 被 销毁 的 情况 。 如 果 activity 是 因 系 统 回 收 内 存 而 
被 销毁 ， 则 所 有 保留 的 fragment 也 会 随 之 被 销毁 ， 数 据 也 就 跟着 丢失 了 。 
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21.12 深入 学 习 : Espresso 与 整合 测试 


在 测试 SoundViewModel 时 ， 我 们 创建 了 SoundViewModelTest 单 元 测试 类 。 实 际 上 ， 我 们 
也 可 以 选择 创建 整合 测试 。 那 么 ,什么 是 整合 测试 ? 

在 单元 测试 里 ， 受 测 对 象 都 是 单个 类 。 在 整合 测试 里 ， 受 测 对 象 是 整个 应 用 。 通 常 测 试 要 覆 
善 每 个 页 面 。 例 如 , 我 们 会 测试 BeatBoxActivity 界 面 出 现 后 ,第 一 个 按钮 显示 的 文件 名 是 不 是 
来 自 sample sounds 里 的 第 一 个 文件 : 65_cjipie。 

相 比 应 用 按 设想 实现 ， 只 有 当 应 用 按 设想 运行 时 ,整合 测试 才 算 通 过 。 修 改 某 个 按钮 ID 的 名 
字 并 不 会 影响 应 用 的 功能 。 但 是 ， 如 果 你 写 了 这 样 一 个 整合 测试 用 例 ,“ 调 用 findViewById 
(R.id.button) 方 法 ,确认 找到 的 按钮 上 的 文字 显示 正确 ”， 那 么 显然 这 个 测试 通 不 过 。 所 以 ， 
整合 测试 应 该 用 UI 测试 框架 工具 来 写 ， 而 不 是 使 用 像 findViewById (int) 这 样 的 标准 库 工具 。 
这 样 可 以 很 容易 写 出 类 似 这 样 的 用 例 :“ 确 保 屏 幕 上 有 个 按钮 ， 上 面 显示 我 设想 的 文字 。” 

Espresso 是 Google 开 发 的 一 个 UI 测试 框架 ， 可 用 来 测试 Android 应 用 。 在 app/build.gradle 文 件 
中 ,添加 com.android.support.test.espresso:espresso-core 依 赖 项 ,作用 范围 改 为 androidTestCompile， 
就 可 以 引入 它 。 

引入 Espresso 之 后 ， 就 可 以 用 它 来 测试 某 个 activity 的 行为 。 例 如 ， 如 果 想 断定 屏幕 上 某 个 视 
图 显示 了 第 一 个 sample_sounds 受 测 文件 的 文件 名 ， 就 可 以 编写 如 下 的 测试 用 例 : 
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GRunwWith(AndroidJUnit4.cLass) 
public class BeatBoxActivityTest { 
@Rule 
public ActivityTestRule<BeatBoxActivity> mActivityRule = 
new ActivityTestRule<>(BeatBoxActivity.class); 
@Test 
public void showsFirstFileName() { 
onView(withText("65 cjipie")) 
.Check(matches (anything())); 


} 


现在 来 解读 一 下 样 例 代码 。 首 先 看 其 中 的 注解 。@RunWith(AndroidJUnit4.class) 表 明 ， 
这 是 一 个 Android 工 具 测 试 ， 需 要 activity 和 其 他 Android 运 行 时 环境 支持 。 之 后 ,mActivityRule 
上 的 @Rule 注 解 告诉 JUnit， 运 行 测试 前 ， 要 启动 一 个 BeatBoxActivity 实 例 。 

准备 工作 做 完 ， 接 下 来 就 可 以 在 测试 方法 里 对 BeatBoxActivity 做 断定 测试 了 。 在 
showsFirstFileName() 方 法 里 ，onView(withText("65 cjipie")) 这 行 代码 会 找到 显示 
“65_cjipie” 的 视图 ， 然 后 对 其 执行 测试 。check(matches(anything() ) ) 用 来 判定 有 这 样 的 视 
图 。 如 果 没 有 ， 则 测试 失败 。 相 较 于 JUnit 的 assertThat (...) 上 断言 方法 ，check(...) 方 法 是 
Espresso 版 的 断言 方法 。 

有 时 ， 你 可 能 还 想 点 击 某 个 视图 ， 然 后 使 用 断言 验证 点 击 结果 。 可 以 让 Espresso 点 击 这 个 视 
图 ， 或 者 使 用 下 面 这 样 的 代码 交互 ; 


onView(withText("65 cjipie")) 
.perform(click()); 


与 视图 交互 时 , Espresso 会 等 待 应 用 闲置 再 执行 下 一 个 测试 。 Espresso 有 一 套 探测 UI 是 否 已 更 
新 完毕 的 方法 。 如 果 需 要 , 也 可 使 用 IdLingResource 的 一 个 子 类 告诉 Espresso: 多 等 一 会 儿 ， 应 
用 还 在 忙 。 

有 关 如 何 使 用 Espresso 做 UI 测试 的 更 详细 的 信息 ， 请 阅读 Espresso 的 文档 ( google.github.io/ 
android-testing-support-library/docs/espresso )。 

单元 测试 和 整合 测试 用 处 各 异 。 单 元 测试 简单 快速 ,多 用 用 就 会 形成 习惯 , 所 以 能 让 大 多 数 
人 接受 并 喜欢 。 整 合 测试 需要 花 很 多 时 间 ， 不 适合 做 经 常 性 的 测试 。 然 而 ,不 管 怎 样 ， 这 两 类 测 
试 都 很 重要 ， 各 自 能 从 不 同 视角 检验 应 用 。 所 以 ， 只 要 有 条 件 ， 二 者 都 不 能 少 。 


21.13 ”深入 学 习 : 虚拟 对 象 与 测试 


相 比 单元 测试 , 虚拟 对 象 在 整合 测试 中 扮演 了 更 为 不 寻常 的 角色 。 虚 拟 对 象 假扮 成 其 他 不 相 
干 的 组 件 ， 其 作用 就 是 隔离 受 测 对 象 。 单 元 测试 的 受 测 对 象 是 单个 类 ; 每 个 类 都 有 自己 不 同 的 依 
赖 关系 ,所 以 ,每 个 受 测 类 也 有 一 套 不 同 于 其 他 类 的 虚拟 对 象 。 既 然 都 是 些 不 同 的 虚拟 对 象 , 那 
么 它们 各 自 的 具体 行为 怎么 样 ， 怎 么 实现 ， 一 点 也 不 重要 。 所 以 ， 对 于 单元 测试 来 说 ,一些 虚 拟 
化 框架 ， 比 如 能 快速 创建 虚拟 对 象 的 Mockito， 就 非常 有 用 了 。 
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再 来 看 整合 测试 。 在 整合 测试 场景 中 ， 虚 拟 对 象 显然 不 能 用 来 隔离 应 用 ， 相反， 我 们 用 它 把 
应 用 和 可 能 的 外 部 交互 对 象 隔 离开 来 ， 如 提供 web service 假 数据 和 假 反 馈 。 如 果 是 在 BeatBox 应 
用 里 ,你 很 可 能 就 要 提供 虚拟 SoundPool， 让 它 告诉 你 某 个 声音 文件 何 时 播放 。 显 然 ， 相 比 常 见 
的 行为 虚拟 , 这 种 虚拟 太 重 了 , 而 且 还 要 在 很 多 整合 测试 里 共享 。 这 真 不 如 手动 写 假 对 象 。 所 以 ， 
做 整合 测试 时 ， 最 好 避免 使 用 像 Mockito 这 样 的 自动 虚拟 测试 框架 。 


21.14 ”挑战 练习 : 播放 进度 控制 
让 用 户 快速 多 听 一 些 声音 ， 请 给 BeatBox 应 用 添加 播放 进度 控制 功能 。 完 成 后 的 界面 如 图 


21-12 所 示 。 提 示 : 在 BeatBoxFragment 中 ， 使 用 SeekBar 组 件 ( developer.android.com/reference/ 
android/widget/SeekBar.html ) 控制 SoundPool 的 play(int, float, float, int, int, float) 


方法 的 播放 速率 参数 值 。 
BL ES 
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图 21-12” 带 播放 进度 控制 的 BeatBox 应 用 
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既然 BeatBox 应 用 的 音效 能 吓 退 人 ， 它 的 用 户 界 面 也 应 透 出 一 定 的 威 慨 力 。 

当前 ，BeatBox 应 用 依然 还 是 一 副 Android 千 年 不 变 的 老 面 孔 。 按 钮 普通 ， 配 色 灰 暗 。 整 个 应 
用 看 上 去 毫 不 起 眼 ， 没 有 品牌 特色 。 

不 过 我 们 有 技术 ， 使 用 样式 和 主题 ， 就 能 定制 出 漂亮 的 用 户 界 面 。 

定制 界面 的 最 终 效果 如 图 22-1 所 示 。 与 之 前 相 比 ， 新 界面 更 加 美观 、 惹 眼 ， 独 具 风 格 。 
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图 22-1 ”应 用 了 主题 的 BeatBox 








22.1 颜色 资源 


首先 , 我 们 来 定义 本 章 要 用 到 的 颜色 资源 。 参 照 代码 清单 22-1， 在 res/values 中 编辑 colors.xml 
文件 。 
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代码 清单 22-1 定义 几 种 颜色 (res/values/colors.xml ) 


<resources> 
<color name="colorPrimary">#3F51B5</color> 
<color name="colorPrimaryDark">#303F9F</color> 
<color name="colorAccent">#FF4081</color> 


<color name="red">#F44336</color> 

<color name="dark_red">#C3352B</color> 

<color name="gray">#607D8B</color> 

<color name="soothing_blue">#0083BF</color> 

<color name="dark_blue">#005A8A</color> 
</resources> 


使 用 颜色 资源 ， 可 以 方便 地 在 一 处 定义 各 种 颜色 值 ， 然 后 在 整个 应 用 里 引用 。 


22.2 ”样式 


现在 ， 我 们 来 给 按钮 添加 样式 。 样 式 是 能 够 应 用 于 视图 组 件 的 一 套 属性 。 
打开 res/values/styles.xml 样 式 文件 ， 添 加 BeatBoxButton 新 样式 ， 如 代码 清单 22-2 所 示 。( 创 
建 BeatBox 项 目 时 ， 向 导 会 创建 默认 的 styles.xml 文 件 。 如 果 没 有 ， 请 自行 创建 。) 


代码 清单 22-2 ”添加 样式 (res/values/styles.xml ) 


<resources> 






































<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


<style name="BeatBoxButton"> 
<item name="android:background">@color/dark_blue</item> 
</style> 


</resources> 


新 建 样 式 名 叫 BeatBoxButton。 该 样式 仅 定义 了 android:background 属 性 ,属性 值 为 深蓝 
色 。 样 式 可 以 为 很 多 组 件 共 用 ， 更 新 修改 属性 时 ， 只 修改 公共 样式 定义 就 行 了 。 
定义 好 样式 ， 把 它 添加 给 各 个 按钮 ， 如 代码 清单 22-3 所 示 。 


代码 清单 22-3 ”使 用 样式 (res/layout/list_ item sound.xml ) 


<Button 
style="@style/BeatBoxButton" 
android:layout width="match parent" 
android:layout height="120dp" 
android:onClick="@{() -> viewModel .onButtonClicked()}" 
android:text="@{viewModel .title}" 
tools:text="Sound name"/> 











| 
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运行 BeatBox 应 用 。 可 以 看 到 ， 所 有 按钮 的 背景 都 是 深蓝 色 了 ， 如 图 22-2 所 示 。 


BeatBox 








图 22-2 添加 了 样式 的 按钮 
如 果 需 要 ， 可 以 创建 带 多 套 属性 的 样式 在 应 用 里 复 用 。 这 真是 方便 。 


样式 继承 


样式 支持 继承 。 一 个 样式 能 继承 并 禾 盖 其 他 样式 的 属性 。 
创建 一 个 名 叫 BeatBoxButton.Strong 的 新 样式 。 除 了 继承 BeatBoxButton 样 式 的 按钮 背景 
属性 ， 再 添加 自己 的 android:textStytLe 属 性 ， 用 粗 体 显示 按钮 文字 ， 如 代码 清单 22-4 所 示 。 


代码 清单 22-4 ”继承 样式 (res/layout/styles.xml ) 


<style name="BeatBoxButton"> 
<item name="android:background">@color/dark blue</item> 
</style> 


























<style name="BeatBoxButton.Strong"> 
<item name="android:textStyle">bold</item> 
</style> 


( 当然, 可 以 直接 对 BeatBoxButton 样 式 添加 这 个 android:textStyle 属 性 。 创建 BeatBox- 
Button.Strong 样 式 只 是 为 了 演示 样式 继承 。) 

新 样式 的 命名 有 点 特别 。BeatBoxButton.Strong 的 命名 表明 ， 个 新 样式 继承 了 
BeatBoxButton 样 式 的 属性 。 

除了 通过 命名 表示 样式 继承 关系 ， 也 可 以 采用 指定 父 样式 的 方式 : 



































22.3 主题 3S7 

<style name="BeatBoxButton"> 

<item name="android:background">@color/dark blue</item> 
</style> 
<style name="StrongBeatBoxButton" parent="@style/BeatBoxButton"> 

<item name="android:textStyle">bold</item> 
</style> 
虽然 有 新 方式 用 于 继承 样式 ，BeatBox 应 用 还 是 继续 使 用 特殊 命名 方式 。 
更 新 list_item_soundxml 布 局 ， 用 上 新 的 粗 体 文字 样式 ， 如 代码 清单 22-5 所 示 。 区 

代码 清单 22-5 ”使 用 粗 体 文字 样式 〈res/layoutlist item sound.xml ) 

<Button 


style="@style/BeatBoxButton.Strong" 

android:layout width="match parent" 

android:layout height="120dp" 

android:onClick="@{() -> viewModel .onButtonClicked()}" 
android:text="@{viewModel .title}" 

tools:text="Sound name"/> 


运行 应 用 ,确认 按钮 文字 已 显示 为 粗 体 ， 如 图 22-3 所 示 。 





BeatBox 











图 22-3 ”使 用 了 粗 体 文字 样式 的 BeatBox 


22.3 ”主题 


样式 很 有 用 。 在 styles.xml 公 共 文 件 中 ,可 以 为 所 有 组 件 定 义 一 套 样式 属性 共用 。 可惜, 定义 
公共 样式 属性 虽 方 便 , 实际 应 用 却 很 麻烦 : 需要 逐个 为 所 有 组 件 添 加 它们 要 用 到 的 样式 。 要 是 开 


[ss 
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发 一 个 复杂 应 用 ， 涉 及 很 多 布局 、 无 数 按钮 ， 仅 仅 添 加 样式 就 累 死 人 了 。 

该 是 主题 闪 亮 登场 的 时 候 了 ! 主题 可 看 作 样 式 的 进化 加 强 版 。 同 样 是 定义 一 套 公 共 主 题 属性 ， 
样式 属性 需要 逐个 添加 , 而 主题 属性 则 会 自动 应 用 于 整个 应 用 。 主题 属性 能 引用 颜色 这 样 的 外 部 
资源 ， 也 能 引用 其 他 样式 。 使 用 主题 ， 不 用 找到 每 个 按钮 ， 告 诉 它们 要 用 哪个 主题 。 一 句 话 就 搞 
定 :“ 所 有 按钮 都 使 用 这 个 样式 。” 


修改 默认 主题 


创建 BeatBox 项 目 时 ， 向 导 给 了 它 默认 主题 。 找 到 并 打开 AndroidManifestxml 文 件 ， 可 以 看 
到 application 标 签 下 的 theme 属 性 ， 如 代码 清单 22-6 所 示 。 






































代码 清单 22-6 ”BeatBox 的 默认 主题 ( AndroidManifest.xml ) 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 


package="com.bignerdranch.android.beatbox" > 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:theme="@style/AppTheme"> 


/ebp Litatidns 
</manifest> 
theme 属 性 指向 的 主题 叫 AppTheme。 它 也 定义 在 styles.xml 文 件 中 。 
可 见 ， 主 题 实 际 就 是 一 种 样式 。 但 是 主题 指定 的 属性 有 别 于 样式 。( 稍 后 就 会 看 到 。) 既然 
能 在 manifest 文 件 中 声明 它 ， 主 题 威 力 大 增 。 同 时 解释 了 为 什么 主题 可 以 自动 应 用 于 整个 应 用 。 
要 查看 AppTheme 主 题 定义 ， 只 要 按 住 Command 键 ( Windows 系 统 是 Ctrl 键 )， 点 击 @style/ 
AppTheme，Android Studio 就 会 自动 打开 res/values/styles.xml 文 件 ， 如 代码 清单 22-7 所 示 。 



































代码 清单 22-7 BeatBox 的 AppTheme ( res/values/styles.xml ) 
<resources> 
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
</style> 
<style name="BeatBoxButton"> 
<item name="android:background">@color/dark blue</item> 


</style> 


</resources> 


(本 书 编写 时 , 在 Android Studio 中 创建 的 项 目 都 自 带 AppCompat 主 题 。 如果 你 的 BeatBox 项 目 
没有 ， 请 参考 第 13 章 让 项 目 使 用 AppCompat 库 。) 
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AppTheme 现 在 继承 Theme .AppCompat .Light.DarkActionBar 的 全 部 属性 。 如 有 需要 , 可 以 
添加 自己 的 属性 值 ， 或 是 覆盖 父 主题 的 某 些 属性 值 。 
AppCompat 库 自 带 三 大 主题 : 
口 Theme.AppCompat 一 一 深 色 主 题 
口 Theme.AppCompat .Light 一 一 浅 色 主 题 
口 Theme.AppCompat .Light.DarkActionBar 一 一 带 深 色 工 具 栏 的 浅 色 主题 
把 AppTheme 的 父 主题 修改 为 Theme .AppCompat， 如 代码 清单 22-8 所 示 。 这 样 BeatBox 项 目 就 22 
有 了 一 个 深 色 主题 基板 。 


代码 清单 22-8 改 用 深 色 主题 (res/values/styles.xml ) 


<resources> 




















<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 


</style> 


</resources> 


运行 BeatBox 应 用 ， 查 看 新 的 深 色 主题 ， 如 图 22-4 所 示 。 





BeatBox 


65_CJIPIE 66_INDIOS 67_INDIOS2 


68_INDIOS3 69_OHM-LOKO 


71_HRUUHB 72_HOUB 73_HOUU 


75_JHUEE 76_JOOOAAH 


77_JUOB 78_JUEB 79_LONG-SCREAM 

















图 22-4 ”应 用 了 深 色 主题 的 BeatBox 











22.4 添加 主题 颜色 


现在 ， 基 于 AppTheme 主 题 模板 ， 我 们 来 定制 它 的 属性 。 








Vr 
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在 styles.xml 文 件 中 ， 参 照 代码 清单 22-9 修 改 现 有 三 个 属 | 


代码 清单 22-9 ” 自 定义 主题 属性 (res/values/styles.xml ) 


<style name="AppTheme" parent="Theme.AppCompat"> 
<item name="colorPrimary">@color/ceterPprimary red</item> 
<item name="colorPrimaryDark">@color/eceterPprimaryDark dark_red</item> 
<item name="colorAccent">@color/coetorAccent gray</item> 

</style> 


虽然 这 三 个 主题 属性 看 上 去 和 前 面 的 样式 属性 差不多 , 但 它们 的 应 用 范围 不 一 样 。 样式 属性 
仅 适 用 于 单个 组 件 ， 如 前 面 用 粗 体 显示 按钮 文字 的 textStyLe。 主 题 属性 则 适用 所 有 使 用 同一 主 
题 的 组 件 。 例 如 ， 工 具 栏 会 以 主题 的 cotorPrimary 属 性 设置 自己 的 背景 色 。 

使 用 这 三 个 主题 属性 ， 应 用 界面 大 有 改观 。colorPrimary 属 性 主要 用 于 工具 栏 。 由 于 应 用 
名 称 是 显示 在 工具 栏 上 的 ，colorPrimary 也 可 以 称 为 应 用 品牌 色 。 

colorPrimaryDark 用 于 屏幕 项 部 的 状态 栏 。 从 名 字 可 以 看 出 ， 它 是 深 色 版 colorPrimary。 
注意 ， 只 有 Lollipop 以 后 的 系统 支持 状态 栏 主题 色 。 对 于 之 前 的 系统 ， 无 论 指定 什么 主题 色 ， 状 
态 栏 都 是 不 变 的 黑 底 色 。 图 22-5 展 示 了 这 两 种 主题 色 的 应 用 效果 。 


状态 栏 : colorPrimaryDark 
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BeatBox 工具 栏 ; colorPrimary 
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图 22-5” 带 AppCompat 颜 色 属 性 的 BeatBox 





最 后 ,设置 colorAccent 为 灰色 。 这 个 主题 色 应 该 和 colorPrimary 形 成 反差 效果 ， 主 要 用 
于 给 EditText 这 样 的 组 件 着 色 。 

按钮 组 件 不 支持 着 色 ， 所 以 colorAccent 主 题 色 在 BeatBox 项 目 中 没有 效果 。 不 管 有 没有 用 ， 
这 里 还 是 添加 了 cotLorAccent ， 因 为 最 好 能 配套 使 用 这 三 个 颜色 属性 。 现 在 , 刚 设置 的 主题 色 融 
合 得 很 好 ( 继承 自 父 主题 的 默认 cotLorAccent 可 能 会 和 你 指定 的 其 他 两 种 主题 色 冲突 )， 算 是 打 
下 了 个 好 基础 。 

运行 应 用 查看 主题 效果 。 现 在 ， 应 用 界面 看 起 来 应 该 和 图 22-5 差 不 多 。 





























22.5 ”覆盖 主题 属性 


完成 了 主题 配色 ,我 们 继续 深入 , 看 看 都 有 哪些 主题 属性 可 以 覆盖。 给 你 提 个 醒 ， 主题 深究 
之 路 坎坷 崎 凤 ， 可 不 那么 好 走 。 有 哪些 主题 属性 可 用 ,哪些 能 窗 盖 ,其 至 是 某 些 属性 究 范 有 什么 
作用 , 研究 诸如 此 类 的 问题 时 , 没有 官方 参考 文档 还 是 小 事 , 极 有 可 能 你 就 完全 没 了 方向 。 对 此 ， 
我 们 只 有 一 个 建议 : 阅读 本 书 。 
第 一 个 任务 是 修改 主题 以 更 换 BeatBox 应 用 的 背景 色 。 当 然 ， 你 可 以 打开 res/layoutfragment 
beat_box.xml 文 件 ， 手 工 设置 RecyclerView 视 图 的 android:background 属 性 。 如 果 还 有 其 他 
fragment 和 activity 要 改 ， 都 照 此 处 理 。 这 简直 是 浪费 : 浪费 你 的 时 间 ， 浪 费 应 用 资源 。 

主题 已 经 设置 了 背景 色 ,， 在 此 基础 上 再 设置 其 他 颜色 ， 就 是 自己 给 自己 找事 。 而 且 , 在 应 用 
里 到 处 复制 使 用 背景 属性 设置 代码 也 不 利于 后 期 维护 。 


要 解决 上 述 问题 ,应 设法 覆盖 主题 背景 色 属性 。 为 了 找 出 可 覆盖 属性 的 名 字 ， 先 来 看 看 这 个 
性 在 其 Theme.AppCompat 父 主题 里 是 怎么 设置 的 。 
你 可 能 会 想 :“ 不 知道 名 字 ， 我 怎么 知道 该 覆盖 哪个 属性 呢 ? ”确实 是 这 样 。 所 以 ， 首 先 查 
看 目标 属性 的 名 字 ， 凭 直觉 挑 一 个 ,覆盖 它 ， 然 后 运行 应 用 验证 猜想 。 
你 需要 找 出 主题 继承 的 源头 。 主 题 继承 树 有 多 深 , 谁 也 不 知道 ， 只 能 一 层 层 向 上 找 , 一 直 找 
到 目标 为 止 。 
打开 styles.xml 文 件 ， 按 住 Command 键 ( Windows 系 统 是 Ctrl 键 ) 点 击 Theme .AppCompat， 来 
看 看 继承 有 多 深 。 
( 如 果 无 法 直接 在 Android Studio 里 追溯 主题 属性 ， 或 是 想 在 工具 之 外 查找 ， 可 以 在 
your-SDK-directory/platforms/android-24/datares/values 目 录 找 到 主题 源码 。) 
Android 开 发 工具 更 新 频繁 ， 本 书 编写 时 ，Android Studio 会 定位 到 一 个 大 文件 的 这 行 : 
<style name="Theme.AppCompat" parent="Base.Theme.AppCompat" /> 
可 知 Theme.AppCompat 主 题 属性 继承 自 Base.Theme.AppCompat 。 有 趣 的 是 ，Theme. 
AppCompat 本 身 没有 履 盖 任何 属性 ， 仅 仅 指 向 了 其 父 主题 。 
按 住 Command 键 再 点 击 Base.Theme .AppCompat，Android Studio 会 提示 ， 这 个 主题 有 资源 修 
饰 符 ， 有 多 个 版 本 可 选 。 
选择 values/values.xml 版 本 ， 定 位 到 如 图 22-6 所 示 的 主题 定义 。 


<style name="Theme.AppCompat'” parent="Base.Theme.AppCompat"/> 

<style name="Theme.AppCompat.CompactMenu" parent= Choose Declaration 
<style name="Theme.AppCompat .DayNight"” parent="TI BE 
<style name="Theme -AppCompat DayNight.DarkActionB Base.Theme.AppCompat (.../values/values.xml) appcompat: st 24.2.0 Ci 
<style name="Theme.AppCompat.DayNight.Dialog" par Base.Theme.AppCompat (.../values-v21/values-v21.xml) appcompat 
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<style name="Theme.AppCompat.DayNight.Dialog.Aler Base.Theme.AppCompat (.../values-v22/values-v22.xml) pp 


<style name="Theme.AppCompat.DayNight.Dialog.Mind Base.Theme.AppCompat (.../values-v23/values-v23.xml) appcompat-v7 
<style name="Theme.AppCompat .DayNight .DialogWhenLarge—parent= rmemes DOmpa CL ;Iacogmmencarge-7> 


Zetvla nama-'Thama Annfnmnat NavNinht NnArtinnRar" narant—"Thama Annfnmnat linht NnArtinnRar"/~ 


图 22-6 ”选择 父 主题 
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(BeatBox 支 持 19 及 以 上 API 级 别 , 所 以 这 里 选择 了 无 修饰 版 本 。 如 果 选 择 v21 版 本 , 很 可 能 还 
会 看 到 API 21 级 里 添加 的 新 特性 。) 


<style name="Base.Theme.AppCompat" parent="Base.V7.Theme.AppCompat"> 
</style> 


Base.Theme.AppCompat 这 个 主题 没 任何 自己 的 定义 ， 也 就 是 说 没 覆 盖 任 何 属性 。 继 续 定 位 
到 它 的 父 主题 : Base.V7.Theme，AppCompat。 


























<style name="Base.V7.Theme.AppCompat" parent="Platform.AppCompat"> 
<item name="windowNoTitle">false</item> 
<item name="windowActionBar">true</item> 
<item name="windowActionBar0verLay">faLse</item> 
</style> 
距离 目标 越 来 越 近 了 。Base.V7.Theme.AppCompat 有 许多 属性 ， 但 还 是 没 找到 改变 背景 
的 属性 。 继续 定位 到 Platform.AppCompat。 这 个 主题 也 有 多 个 版 本 , 选择 values/values.xml 版 本 。 


<style name="Platform.AppCompat" parent="android:Theme"> 
<item name="android:windowNoTitle">true</item> 




















<!-- Window colors --> 


<item name="android:colorForeground">@color/foreground material dark</item> 
<item name="android:colorForegroundinverse">@color/ 


foreground material light</item> 

</style> 

终于 ， 在 这 里 看 到 了 Platform.AppCompat 的 android:Theme 父 主题 。 

注意 ， 这 里 引用 的 不 是 Theme ， 而 是 android:Theme。 前 面 的 android 命 名 空间 不 能 

AppCompat 库 可 以 看 作 BeatBox 应 用 的 一 部 分 。 编 译 项 目 时 ， 工 具 会 引入 AppCompat 库 和 它 
的 一 堆 Java 和 XML 文 件 。 这 些 文件 已 包含 在 应 用 里 ， 如 同 你 自己 编写 的 文件 。 如 果 想 引用 
AppCompat 库 里 的 资源 ， 像 Theme .AppCompat 这 样 ， 直 接 引 用 就 可 以 了 。 

有 些 主题 包含 在 Android 操 作 系 统 里 ， 如 Theme, 引用 时 必须 加 上 指向 归属 地 的 命名 空间 。 在 
引用 Theme 主 题 时 ，AppCompat 库 使 用 了 android:Theme 这 样 的 形式 ， 这 是 因为 Theme 来 自 于 
Android 操 作 系 统 。 

总 算 找到 了 。 在 这 里 ,终于 可 以 看 到 所 有 可 以 覆盖 的 主题 属性 。 当 然 ， 还 可 以 继续 定位 到 
Theme 主 题 ， 不 过 没 这 个 必要 。 我 们 想 要 的 属性 已 经 找到 了 。 

查看 代码 ， 可 以 看 到 windowBackground 这 个 属性 。 顾 名 思 义 ， 这 就 是 用 于 主题 背景 色 的 
属性 。 

<style name="Platform.AppCompat" parent="android:Theme"> 

<item name="android:windowNoTitle">true</item> 










































































<!-- Window colors --> 
<item name="android:colorForeground">@color/foreground material dark</item> 
<item name="android:colorForegroundinverse">@color/ 

foreground material light</item> 
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<item name="android:colorBackground">@color/background material dark</item> 
<item name="android:colorBackgroundCacheHint">@color/ 

abc background cache hint selector material dark</item> 
<item name="android:disabledAlpha">@dimen/abc disabled alpha material dark</item> 
<item name="android:backgroundDimAmount">0.6</item> 
<item name="android:windowBackground">@color/background material dark</item> 


ye 
这 也 是 要 在 BeatBox 应 用 中 覆盖 的 属性 。 回 到 styles.xml 文 件 中 ， 和 覆盖 windowBackground 这 
个 属性 ， 如 代码 清单 22-10 所 示 。 


代码 清单 22-10 设置 窗口 背景 (res/values/styles.xml ) 


<style name="AppTheme" parent="Theme.AppCompat "> 
<item name="colorPrimary">@color/red</item> 
<item name="colorPrimaryDark">@color/dark red</item> 
<item name="colorAccent">@color/gray</item> 











<item name="android:windowBackground">@color/soothing_blue</item> 
</style> 


注意 ，windowBackground 这 个 属性 来 自 Android 操 作 系 统 ， 所 以 别 忘 了 使 用 android 命 名 
空间 。 

运行 BeatBox 应 用 。 滚 动 到 recycler 视 图 底部 查看 背景 ， 没 有 按钮 覆盖 的 地 方 是 浅 蓝 色 ， 如 网 
22-7 所 示 。 








BeatBox 


75_JHUEE 76_JOOOAAH 


77_JUOB 78_JUEB 79_LONG-SCREAM 
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图 22-7 设置 了 主题 背景 的 BeatBox 


想 修改 应 用 主题 , 开发 者 差不多 都 要 经 历 刚 才 查找 windowBackground 属 性 的 过 程 。 没 办 法 ， 
属性 没有 什么 文档 可 参考 ， 只 能 去 看 源 代码 了 。 
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总 结 一 下 ， 刚 才 我 们 定位 查看 了 以 下 主题 : 
口 Theme .AppCompat 





口 Base.Theme.AppCompat 
口 Base.V7.Theme.AppCompat 
D Platform.AppCompat 

刚才 我 们 自 下 而 上 逐 层 定位 ， 直 到 找到 AppCompat 根 主题 。 将 来 ， 越 来 越 熟 练 之 后 ， 你 很 可 
能 会 跳 过 中 间 步 又 而 直达 上 和 目标。 不过， 建议 还 是 按部就班 ， 以 此 看 清楚 究竟 哪个 是 根 主题 。 

最 后 青 提 个 醒 ， 主 题 继 承 关系 和 层次 可 能 有 变 ( 发 布 新 系统 )， 但 上 面 介 绍 的 方法 不 会 变 。 
想 要 知道 该 覆盖 哪个 属性 ， 就 沿 着 继承 树 找 吧 1 


22.6 ”修改 按钮 属性 


前 面 , 通过 在 res/layout/list_item_sound.xml 文 件 中 手工 设置 样式 属性 , 我 们 定制 过 BeatBox 应 
用 的 按钮 。 如 果 一 个 复杂 应 用 有 很 多 fragment， 都 有 很 多 按钮 ， 再 去 逐个 ffagment 、 逐 个 按钮 地 
去 设置 style 属 性 就 很 不 应 该 了 。 在 这 种 情况 下 ， 还 是 要 靠 主 题 。 你 可 以 在 主题 中 定义 一 个 用 于 
所 有 按钮 的 样式 。 

在 主题 里 添加 按钮 样式 前 ， 先 打开 res/layout/list_item_sound.xml 文 件 ， 删 掉 原 有 样式 属 怕 
如 代码 清单 22-11 所 示 。 


代码 清单 22-11 删 掉 ! 有 更 好 的 办 法 了 (res/layout/list_item sound.xml ) 


<Button 



























































[2 


android:layout width="match parent" 

android:layout height="120dp" 

android:onClick="@{() -> viewModel .onButtonClicked()}" 
android:text="@{viewModel .title}" 

tools:text="Sound name"/> 


运行 BeatBox 应 用 。 可 以 看 到 ， 按 钮 回 到 原来 的 模样 了 。 
再 次 逐 级 定位 查找 主题 。 这 次 , 我 们 找到 Base.V7.Theme.AppCompat 里 的 buttonStyle 属 性 。 
<style name="Base.V7.Theme.AppCompat" parent="Platform.AppCompat"> 


























<!-- Button styles -—-—> 
<item name="buttonStyle">@style/Widget.AppCompat.Button</item> 
<item name="buttonStyleSmall">@style/Widget.AppCompat.Button.Small</item> 


</style> 

这 个 属性 指定 应 用 中 普通 按钮 的 样式 。 

这 个 buttonStytLe 属 性 没有 设置 值 ,而 是 指向 了 一 个 样式 资源 .前面 履 盖 windowBackground 
属性 时 ， 直 接 传 人 了 颜色 值 。 这 里 ，buttonStytLe 应 该 指向 另 一 个 样式 。 定 位 并 查看 Widget , 
AppCompat .Button 样 式 。 
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<style name="Widget .AppCompat .Button” parent="Base.Widget.AppCompat ,Button" /> 


Widget. AppCompat .Button 样 式 没有 定义 任何 属性 ， 继 续 定 位 找 其 指向 的 父 样式 。 你 会 发 
现 有 两 个 版 本 可 选 ， 选 values/values.xml 版 本 。 


<style name="Base.Widget.AppCompat.Button" parent="android:Widget"> 
<item name="android:background">@drawable/abc btn default mtrl shape</item> 
<item name="android:textAppearance">?android:attr/textAppearanceButton</item> 
<item name="android:minHeight">48dip</item> 


<item name="android:minWidth">88dip</item> 
<item name="android:focusable">true</item> 
<item name="android:clickable">true</item> 


<item name="android:gravity">center verticallcenter horizontal</item> 
</style> 


BeatBox 应 用 的 所 有 按钮 都 使 用 了 这 些 属性 。 

在 BeatBox 应 用 里 复 用 Android 自 身 主题 。 修 改 BeatBoxButton 样 式 的 父 样 式 为 Widget. 
AppCompat .Button。 另 外 ， 删 除 BeatBoxButton.Strong 样 式 ， 如 代码 清单 22-12 所 示 。 
代码 清单 22-12 ”创建 按钮 样式 ( res/values/styles.xml ) 


<resources> 

















三 





<style name="AppTheme" parent="Theme.AppCompat"> 
<item name="colorPrimary">@color/red</item> 
<item name="colorPrimaryDark">@color/dark red</item> 
<item name="colorAccent">@color/gray</item> 


<item name="android:windowBackground">@color/soothing blue</item> 
</style> 


<style name="BeatBoxButton" parent=" Widget.AppCompat.Button"> 
<item name="android:background">@color/dark blue</item> 
</style> 


</resources> 


继承 Widget ,AppCompat .Button 样 式 ， 就 是 首先 让 所 有 按钮 都 继承 常规 按钮 的 属性 。 人 然后 
根据 需要 ， 有 选择 性 地 修改 一 些 属性 。 

如 果 不 指 定 BeatBoxButton 样 式 的 父 样式 , 所 有 按钮 会 变 得 不 再 像 个 按钮 , 连 按钮 中 间 显 示 
的 文字 都 会 丢失 。 

BeatBoxButton 样 式 已 重新 定义 完毕 ， 可 以 使 用 了 。 经 过 前 面 主题 深 挖 ， 我 们 知道 要 和 覆盖 
buttonStyle 属 性 。 下 面 覆 盖 buttonStyle 属 性 ， 让 它 指向 BeatBoxButton 样 式 ， 如 代码 清单 
22-13 所 示 。 
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代码 清单 22-13 ”使 用 BeatBoxButton 样 式 (res/values/styles.xml ) 


<resources> 


<style name="AppTheme" parent="Theme.AppCompat"> 
<item name="colorPrimary">@color/red</item> 
<item name="colorPrimaryDark">@color/dark red</item> 
<item name="colorAccent">@color/gray</item> 


<item name="android:windowBackground">@color/soothing blue</item> 
<item name="buttonStyle">@style/BeatBoxButton</item> 
</style> 


<style name="BeatBoxButton" parent="Widget.AppCompat.Button"> 
<item name="android:background">@color/dark blue</item> 
</style> 


</resources> 

注意 ,定义 buttonStyle 时 ,我 们 没有 使 用 android: 前 级 ,这 是 因为 , 要 覆盖 的 buttonStyle 
属性 是 在 AppCompat 库 里 实现 的 。 

现在 ，buttonStyle 属 性 已 被 覆盖 ,你 使 用 了 自 定义 的 BeatBoxButton。 

运行 BeatBox 应 用 ， 所 有 的 按钮 都 变 成 了 深蓝 色 了 ， 如 图 22-8 所 示 。 没 有 直接 修改 任何 布局 ， 
就 改变 了 普通 按钮 的 样子 。Android 主 题 属性 太 强大 了 ! 
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图 22-8” 带 最 终 版 主题 的 BeatBox 


按钮 没有 轮廓 ， 很 不 明显 。 下 一 章 会 做 美化 ， 让 它们 更 美观 。 
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22.7 深入 学 习 : 样式 继承 拾遗 


本 章 前 面 对 样 式 继承 知识 点 的 介绍 还 不 够 全 面 。 在 进行 主题 探秘 时 ， 你 可 能 已 经 注意 到 了 ， 
样式 继承 的 表示 法 时 有 切换 。AppCompat 主 题 都 是 使 用 主题 名 表示 继承 ， 直 到 磁 到 Platform. 
AppCompat 这 个 主题 。 

















<style name="Platform.AppCompat" parent="android:Theme"> 

</style> 

这 里 ， 继 承 是 直接 使 用 parent 属 性 来 表示 的 。 为 什么 呢 ? 

要 以 主题 名 的 形式 指定 父 主 题 ， 有 继承 关系 的 两 个 主题 都 应 处 于 同一 个 包 中 。 因 此 ， 对 于 
Android 操 作 系 统 内 部 主题 间 的 继承 ， 就 可 以 直接 使 用 主题 名 继承 表示 法 。 同 理 ，AppCompat 库 
内 部 也 是 这 样 。 然 而 ， 一 旦 AppCompat 库 要 跨 库 继承 ， 就 一 定 要 明确 使 用 parent 属 性 。 

在 开发 自己 的 应 用 时 , 应 遵守 同样 的 规则 。 如 果 是 继承 自己 内 部 的 主题 , 使 用 主题 名 指定 父 
主题 即 可 ; 如 果 是 继承 Android 操 作 系 统 中 的 样式 或 主题 ， 记 得 使 用 parent 属 性 。 
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在 主题 中 定义 好 属性 后 ， 可 以 在 XML 或 代码 中 直接 使 用 它们 。 
为 了 在 XML 中 引用 主题 属性 ， 我 们 使 用 第 7 章 中 divider 属 性 用 到 的 符号 。 在 XML 中 引用 有 具 
体 值 (如 颜色 值 ) 时 ,我 们 使 用 @ 符 号 。@color/gray 指 向 某 个 特定 资源 。 

在 主题 中 引用 资源 时 ,使 用 ?符号 。 

<Button xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/list item sound button" 
android:layout width="match parent" 
android:layout height="120dp" 


android:background="?attr/colorAccent" 
tools:text="Sound name"/> 


上 述 XML 中 ?符号 的 意思 是 使 用 cotorAccent 属 性 指向 的 资源 。 这 里 , 是 指定 义 在 colors.xml 
文件 中 的 灰色 。 
也 可 以 在 代码 中 使 用 主题 属性 ， 但 是 比较 哩 味 。 


Resources.Theme theme = getActivity().getTheme(); 

int[] attrsToFetch = { R.attr.colorAccent }; 

TypedArray a = theme.obtainStyledAttributes(R.style.AppTheme, attrsToFetch); 
int accentColor = a.getInt(0, 0); 

a.recycle(); 


先 取 得 Theme 对 象 , 然后 要 求 它 找到 定义 在 AppTheme ( 即 R.,style.AppTheme) 中 的 R.attr. 
coLorAccent 属 性 。 结 果 得 到 一 个 持 有 数据 的 TypedArray 对 象 。 接 着 ， 向 TypedArray 对 象 索要 
int 值 以 取出 颜色 。 颜 色 值 取 出 之 后 就 可 以 使 用 了 ， 比 如 ， 用 来 更 改 按钮 背景 色 。 

BeatBox 应 用 中 的 工具 栏 和 按钮 就 是 采取 上 述 方式 使 用 主题 属性 美化 自己 的 。 

























































































































































































XML drawable 











BeatBox 应 用 的 主题 非常 漂亮 ， 下 面 该 是 优化 按钮 表现 的 时 候 了 。 
当前 , 按钮 就 是 个 蓝 方 框 , 点 击 它 也 看 不 到 任何 反应 。 本章, 我 们 将 学 习 使 用 XML drawable， 
继续 美化 BeatBox 应 用 ， 让 它 拥 有 如 图 23-1 所 示 的 用 户 界 面 。 
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图 23-1 ”完全 改观 的 用 户 界面 


在 Android 址 界 里 , 几 是 要 在 屏幕 上 绘制 的 东西 都 可 以 叫 作 drawable， 比 如 抽象 图 形 、Drawable 
类 的 子 类 代码 、 位 图 图 像 等 。 本 章 ， 你 还 会 看 到 更 多 的 drawable: state list drawable 、shape drawable 
和 layer list drawable。 这 三 个 drawable 都 定义 在 XML 文件 中 ， 可 以 归 为 一 类 ， 统 称 为 XML drawable。 


23.1 统一 按钮 样式 


定义 XML drawable 之 前 ， 先 修改 list_ item_sound.xml 文 件 隔 开 按钮 ， 如 代码 清单 23-1 所 示 。 








代码 清单 23-1 隔 开 按钮 ( res/layout/list_ item sound.xml ) 


<Layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
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<data> 
<variable 
name="viewModel" 
type="com.bignerdranch.android.beatbox.SoundViewModel"/> 
</data> 
<FrameLayout 
android:Layout_width="match_parent"” 
android:layout_height="wrap_content" 
android:Layout_margin="8dp"> 
<Button 
android:tayout width="match_parent" 
android:tayout_ height="120dp" 





android:Layout_width="100dp”" 
android:Layout_height="100dp" 
android:layout_gravity="center" 
android:onClick="@{() -> viewModel.onButtonClicked()}" 
android:text="@{viewModel .title}" 
tools:text="Sound name"/> 
</FrameLayout> 
</layout> 


现在 ， 按 钮 的 宽 和 高 都 是 100dp。 这 样 ， 稍 后 变 为 圆 形 时 ， 这 些 按钮 就 不 会 牌 斜 了 。 

不 论 屏幕 大 小 ，recycler 视 图 总 是 显示 三 列 按钮 。 如 果 还 有 多 余 的 空间 ， 它 会 拉 伸 列 格 以 适 
配 屏幕 。 不 过 ，BeatBox 应 用 的 按钮 不 应 拉 伸 ， 所 以 把 它们 封装 在 frame 布 局 里 。 这 样 ，frame 布 局 
会 被 拉 伸 ， 而 按钮 不 会 

运行 BeatBox 应 用 。 按 钮 的 尺寸 都 完全 统一 了 ,并 且 彼 此 之 间 还 留 出 了 空间 ， 如 图 23-2 所 示 。 
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图 23-2” 隔 开 的 按钮 


23.2 shape drawable 





使 用 ShapeDrawable, 可 以 把 按钮 变 成 圆 。XML drawable 和 屏幕 像素 密度 无 关 ,， 所 以 无 需 考 
虑 创建 特定 像素 密度 目录 ， 直 接 把 它 放 和 人 默认 的 drawable 文 件 夹 就 可 以 了 。 
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打开 项 目 工 具 窗 口 ， 在 res/drawable 目 录 下 创建 一 个 名 为 button_beat_box_normal.xml 的 文件 ， 
如 代码 清单 23-2 所 示 。( 稍 后 还 会 创建 一 个 “ 非 正 常 ” 的 文件 ， 所 以 文件 名 里 有 normal 字 样 。) 


代码 清单 23-2 创建 圆 形 drawable (res/drawable/button beat box normal.xml ) 


<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android: shape="oval"> 





<solid 
android:color="@color/dark_blue"/> 


</shape> 

该 XML 文件 定义 了 一 个 背景 为 深蓝 色 的 圆 形 。 也 可 使 用 shape drawable 定 制 其 他 各 种 图 形 ， 
如 长 方形 、 线 条 以 及 梯形 等 。 欲 详细 了 解 shape drawable 定 制 信息 , 可 查看 开发 者 文档 : developer. 
android.com/guide/topics/resources/drawable-resource.html )。 


在 styles.xml 中 , 使 用 新 建 的 button beat box_normal 作 为 按钮 背景 , 如 代码 清单 23-3 所 示 。 


代码 清单 23-3 ”修改 按钮 背景 (res/values/styles.xml ) 


<resources> 








<style name="AppTheme" parent="Theme.AppCompat"> 
</style> 
<style name="BeatBoxButton" parent=" Widget.AppCompat.Button"> 


<item name="android:background">@drawable/button_beat_box_normal</item> 
</style> 


</resources> 


运行 BeatBox 应 用 。 可 以 看 到 ， 圆 形 的 按钮 出 现 了 ， 如 图 23-3 所 示 。 
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23.3 state list drawable 
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点 击 按钮 之 后 会 听 到 播放 的 声音 ,可 按钮 的 样子 却 没 有 任何 变化 。 按 钮 按 下 去 时 ， 如果 能 切 


换 显示 状态 态 ， 用 户 体 验 应 该 会 更 好 。 





23.3 state list drawable 
为 解决 这 个 问题 ， 首 先 定 义 一 个 用 于 按钮 按 下 状态 的 shape drawable。 





在 res/drawable 目 录 下 再 创建 一 个 名 为 button beat box_pressed.xml 的 文件 ， 如 代码 清单 23-4 











所 示 。 除 了 背景 颜色 是 红色 外 ， 这 个 shape drawable 和 前 面 的 正常 版 本 是 一 样 的 。 


代码 清单 23-4 ”定义 按钮 按 下 时 的 shape drawable ( res/drawable/button beat box pressed.xml ) 


<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="oval"> 


<solid 
android:color="@color/red"/> 


</shape> 





接 下 来 ， 要 在 按钮 按 下 时 使 用 这 个 新 建 的 shape drawable。 这 需要 用 到 state list drawable。 
根据 按钮 的 状态 ，state list drawable 可 以 切换 指向 不 同 的 drawable。 按 钮 没有 按 下 的 时 候 指 向 


button beat box_normal， 按 下 的 时 候 就 指向 button beat _box_pressed。 
在 drawable 目 录 中 ， 定 义 一 个 state list drawable， 如 代码 清单 23-5 所 示 。 


代码 清单 23-5 ”创建 一 个 state list drawable ( res/drawable/button beat box.xml ) 


<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:drawable="@drawable/button_beat_box_pressed" 
android:state_pressed="true"/> 
<item android:drawable="@drawable/button_beat box_normal" /> 
</selector> 


现在 , 在 styles.xml 中 修改 按钮 样式 , 改 用 button_beat_box 作 为 按钮 背景 ， 如 代码 清 
所 示 。 


代码 清单 23-6 使 用 state list drawable ( res/values/styles.xml ) 


<resources> 





<style name="AppTheme" parent="Theme.AppCompat"> 
</style> 


Se name="BeatBoxButton" barent andrord: Style/Wioget. Holo. Button > 





<item Pail nd od Dae hora Gr bl een -beat boxe /Len 
</style> 


</resources> 


单 23-6 
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按钮 没有 按 下 的 时 候 使 用 putton beat box_normal 作 背景 ， 按 下 时 就 使 用 putton beat_ 


box_pressed 作 背景 。 


运行 BeatBox 应 用 。 查 看 按 下 状态 的 按钮 背景 ， 如 图 23-4 所 示 。 
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图 23-4” 按 下 状态 的 按钮 


除了 按 下 状态 ，state list drawable 还 支持 禁用 、 聚 焦 以 及 激活 等 状态 。 若 想 详 细 了 解 ， 请 访 
问 网 页 : developer.android.com/guide/topics/resources/drawable-resource.html#StateList。 


23.4 layer list drawable 


BeatBox 应 用 看 起 来 挺 不 错 了 。 按 钮 圆 圆 的 ， 按 下 时 还 有 视觉 反馈 。 不 过 ， 还 要 精益 求 精 。 
layer list drawable 能 让 两 个 XML drawable 合 二 为 一 。 借 助 这 个 工具 ， 可 以 为 按 下 状态 的 按钮 


添加 一 个 深 色 的 圆 环 ， 如 代码 清单 23-7 所 示 。 
代码 清单 23-7 使 用 layer list drawable (res/drawable/button beat box pressed.xml ) 


<Layer-List xmlns:android="http://schemas.android.com/apk/res/android"> 
<item> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="oval"> 


<solid 
android:color="@color/red"/> 
</shape> 
</item> 
<item> 
<shape 
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android:shape="oval"> 


<stroke 
android:width="4dp" 


android:color="@color/dark_red"/> 
</shape> 
</item> 


</Layer-List> 


现在 ，layer list drawable 中 指定 了 两 个 drawable。 第 一 个 是 和 以 前 一 样 的 红 圈 。 第 二 个 则 会 绘 
制 在 第 一 个 圈 上 ， 它 定义 了 一 个 4dp 粗 的 深 红 圈 。 这 会 产生 一 个 暗 红 的 圈 。 

这 两 个 drawable 可 以 组 成 一 个 layer list drawable。 多 个 当然 也 可 以 ， 会 获得 一 些 更 复杂 的 
效果 。 











运行 BeatBox 应 用 ， 随 意 点 击 几 个 按钮 。 可 以 看 到 ， 在 按 下 状态 ， 按钮 有 了 漂亮 的 边 圈 ， 如 
图 23-5 所 示 。 
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图 23-5” 最终 版 BeatBox 


现在 ，BeatBox 应 用 真正 完成 了 。 还 记得 应 用 最 初 的 样子 吗 ? 两 相对 比 ， 简 直 云 泥 之 别 。 实 
践 证 明 ， 精 美的 应 用 让 人 用 起 来 舒心 ， 容 易 获得 用 户 的 青睐 。 


23.5 深入 学 习 : 为 什么 要 用 XML drawable 


应 用 总 需要 切换 按钮 状态 ， 所 以 state list drawable 是 Android 开 发 不 可 或 缺 的 工具 。 那 shape 
drawable 和 layer list drawable 呢 ? 应 该 用 吗 ? 


XML drawable 用 起 来 方便 灵活 ， 不 仅 用 法 多 样 ， 还 易于 更 新 维护 。 搭 配 使 用 shape drawable 





374 第 23 章 XML drawable 





和 layer list drawable 可 以 做 出 复杂 的 背景 图 ， 连 图 像 编辑 器 都 省 了 。 更 改 BeatBox 应 用 的 配色 更 是 
简单 ， 直 接 修改 XML drawable 中 的 颜色 就 行 了 。 

另外 ，XML drawable 独 立 于 屏幕 像素 密度 ， 可 在 不 带 屏 幕 密度 资源 修饰 符 的 drawable 目 录 中 
直接 定义 。 如 果 是 普通 图 像 ， 就 需要 准备 多 个 版 本 ， 以 适 配 不 同 屏幕 像素 密度 的 设备 ; 而 XML 
drawable 只 要 定义 一 次 ， 就 能 在 任何 设备 的 屏幕 上 表现 出 色 。 


23.6 ”深入 学 习 : 使 用 mipmap 图 像 


资源 修饰 符 和 drawable 用 起 来 都 很 方便 。 应 用 要 用 到 图 像 ， 就 针对 不 同 的 设备 尺寸 准备 不 同 
尺寸 的 图 片 ， 再 分 别 放 入 drawable-mdpi 和 drawable-hdpi 这 样 的 文件 来。 然后 ， 按 名 字 引 用 它们 。 
剩 下 的 就 交 给 Android 了 ， 它 会 根据 当前 设备 的 屏幕 密度 调用 相应 的 图 片 。 

但 是 ， 有 个 问题 不 得 不 提 。 发 布 应 用 到 Google 应 用 商店 时 ，APK 文 件 包 含 了 项 目 drawable 目 
录 里 的 所 有 图 片 。 这 里 面 有 些 图 片 甚 至 从 来 不 会 用 到 。 这 是 个 负担 。 

为 解决 这 个 问题 ， 有 人 想到 针对 设备 定制 APK， 比 如 mdpi APK 一 个 ，hdpi APK 一 个 ， 等 等 。 
(有 关 APK 分 包 的 详细 信息 ， 可 参阅 工具 文档 网 页 : tools.android.com/tech-docs/new-build-system/ 
User-guide/apk-splits。) 

但 问题 解决 得 不 够 彻底 。 假 如 想 保留 各 个 屏幕 像素 密度 的 启动 图 标 呢 ? 

Android 启 动 器 是 个 常 驻 主屏 幕 的 应 用 ( 详 见 第 24 章 )。 按 下 设备 的 主屏 幕 键 ， 会 回 到 启动 器 
应 用 界面 。 

有 些 新 版 启动 器 会 显示 大 尺寸 应 用 图 标 。 想 让 大 图 标清 晰 好 看 ,启动 器 就 需要 使 用 更 高 分 辩 
率 的 图 标 。 对 于 hdpi 设 备 ， 要 显示 大 图 标 ， 启 动 器 就 会 使 用 xhdpi 图 标 。 找 不 到 的 话 ， 就 只 能 使 用 
低 分 辩 率 的 图 标 。 可 想 而 知 ， 放 大 拉 伸 后 的 图 标 肯定 很 粳 。 

Android 的 另 一 解决 办 法 是 使 用 mipmap 目 录 。 本 书 编写 时 ，Android Studio 中 的 新 项 目 已 经 可 
以 使 用 mipmap 资 源 作为 应 用 的 启动 图 标 了 ， 如 图 23-6 所 示 。 
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图 23-6” mipmap 图标 


应 用 启动 器 图 标 放 在 mipmap 目 录 中 ， 其 他 图 片 都 放 在 drawable 











据 此 , 我 们 有 个 推荐 做 法 : 于 
目录 中 。 











[中 
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23.7 深入 学 习 : 使 用 9-patch 图 像 


有 时 候 (也 可 能 经 常 )， 按钮 背景 图 必须 用 到 普通 图 片 。 那 么 ， 如 果 按 钮 需要 以 不 同 尺 寸 显 
示 ， 背 景 图 该 如 何 变化 呢 ? 
如 果 按 钮 的 宽度 大 于 背景 图 的 宽度 ， 图 片 会 被 拉 伸 。 拉 伸 的 图 片 会 有 很 好 的 效果 吗 ? 

朝 一 个 方向 拉 伸 背景 图 很 可 能 会 让 图 片 失去 原样 ， 所 以 得 想 个 办 法 控制 图 片 拉 伸 方式 。 

本 节 ， 改 造 BeatBox 应 用 按钮 ， 我 们 使 用 9-patch 图 片 做 其 背景 (不 明白 没关系 ， 稍 后 就 知道 
了 )。 注意 ,之 所 以 改造 ， 并 不 是 说 9-patch 更 适合 BeatBox。 我 们 仅仅 是 想 告诉 你 9-patch 是 如 何 工 
作 的 ， 在 将 来 需要 的 时 候 ， 你 该 如 何 使 用 它 。 

首先 ， 修 改 list_item_sound.xml 文 件 ， 人 允许 按 钮 随 屏幕 大 小 动态 调整 ， 如 代码 清单 23-8 所 示 。 


代码 清单 23-8 ”人 允许 拉 伸 按钮 (res/layout/list item sound.xml ) 


<layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<data> 
<variable 
name="viewModel" 
type="com.bignerdranch.android.beatbox.SoundViewModel"/> 
</data> 
<FrameLayout 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:layout margin="8dp"> 
<Button 
android:layout width="199dP-match_parent" 
android:layout height="190dp match_parent" 
android:layout gravity="center" 
android:onClick="@{() -> viewModel .onButtonClicked()}" 
android:text="@{viewModel .title}" 
tools:text="Sound name"/> 
</FrameLayout> 
</Layout> 


调整 后 ， 按 钮 会 使 用 多 余 空间 ， 按 钮 的 间隔 还 是 gdp。 新 按钮 背景 图 有 个 折 和 角 和 阴影 ， 如 图 
23-7 所 示 。 这 是 按钮 的 新 背景 图 。 

































































图 23-7 新 背景 图 ( res/drawable-xxhdpiic_ button_ beat box default.png ) 


在 随 书 文件 的 xxhdpi drawable 目 录 里 〈 对 应 本 章 )， 找 到 包括 按 下 状态 在 内 的 两 个 新 背景 图 ， 
复制 到 BeatBox 项 目的 drawable-xxhdpi 目 录 中 。 然后 修改 button _ beat box.xml 文 件 使 用 它们 ,， 如 代 
码 清单 23-9 所 示 。 
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代码 清单 23-9 ”使 用 新 背景 图 (res/drawable/button beat box.xml ) 


<selector xmlns: no "http://schemas.android.com/apk/res/android"> 
= beat_ box_pressed!" 
<item android:drawable="@drawable/ic_button_beat box_pressed" 
android.state pressed="true"/> 
= beat_box_normalt!" 
<item android:drawable="@drawable/ic_button_ beat_ box_default" 
</selector> 


运行 应 用 ， 查 看 按钮 显示 效果 ， 如 图 23-8 所 示 。 
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图 23-8 ”难看 的 背景 图 
听 ， 这 也 太 丑 了 吧 ! 








~ 


能 控制 该 拉 伸 的 部 分 拉 伸 ， 不 该 拉 伸 的 不 拉 伸 就 好 了 。 
使 用 9-patch 图 像 能 解决 这 个 问题 。9-patch 图 像 是 一 种 特别 处 理 过 的 文件 ， 外 








为 什么 这 么 丑 ? 原 来 ，Android 向 四 面 拉 伸 了 ic_beat_box_button.png, 包括 折 边 和 圆 角 。 要 是 


能 让 Android 知 道 


图 像 的 哪些 部 分 可 以 拉 伸 ,哪些 部 分 不 可 以 。 只 要 处 理 得 当 ， 就 能 确保 背景 图 的 边 角 与 原始 图 像 


保持 一 致 。 


为 什么 要 叫 作 9-patch 呢 ?9 9-patch 图 像 分 成 3 x 3 的 网 格 ， 即 由 9 部 分 或 9 patch 组 成 的 网 格 。 网 





格 角落 部 分 不 会 被 缩放 , 边缘 部 分 的 4 个 patch 只 按 一 个 维度 缩放 , 而 中 间 部 分 则 按 两 个 维度 缩放 ， 


如 图 23-9 所 示 。 

















9-patch 图 像 和 普通 PNG 图 像 十 分 相似 ， 只 有 两 处 不 同 : 9-patch 图 像 文件 名 以 .9.png 结 尾 ， 图 
像 边缘 具有 1 像素 宽度 的 边框 。 这 个 边框 用 以 指定 9-patch 图 像 的 中 间 位 置 。 边 框 像素 绘制 为 黑 线 ， 


以 表明 中 间 人 位置， 边缘 部 分 则 用 透明 色 表 示 。 
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图 23-9 ”9-patch 拉 伸 原 理 


任意 图 形 编辑 器 都 可 用 来 创建 9-patch 图 像 ， 但 Android SDK 自 带 的 draw9patch 工 具 用 起 来 更 
方便 。 
首先 , 把 两 张 新 背 景 图 转换 为 9-patch 图 像 。 在 项 目 工 具 窗 口中 , 右键 单 击 ic_button_beat_box 











defaultpng， 选 择 Refactor 一 Rename... 菜 单项 将 其 改名 为 ic_button beat box_default.9.png。( 如 果 
Android Studio 提 示 有 同名 资源 ， 直 接点 Continue 按 钮 继续 。) 再 用 相同 的 步骤 得 到 另 一 个 文件 : 
ic_ button beat box pressed.9.png。 

然后 ， 双 击 默 认 图 片 在 Android Studio 内 置 的 9-patch 工 具 中 打开 ， 如 图 23-10 所 示 。( 如 果 
Android Studio 没 能 顺利 打开 9-patch 编 辑 器 ， 请 先 关闭 图 片 文件 ， 并 在 项 目 工具 窗口 中 展开 
drawable 目 录 ， 再 尝试 重新 打开 它 。) 

在 9-patch 工 具 中 ， 首 先 ， 为 让 图 片 更 醒目 ， 勾 选 上 Show patches 选 项 。 然 后 ， 把 图 像 顶 部 和 
左边 框 填充 为 黑色 ， 以 标记 图 像 的 可 伸缩 区 域 ( 见 图 23-10 )。 
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图 23-10 ”创建 9-patch 图 像 
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图 片 的 项 部 黑 线 指定 了 水 平方 向 的 可 拉 伸 区 域 。 左边 的 黑 线 标记 在 竖 直 方向 哪些 像素 可 以 拉 伸 。 
重复 上 述 步骤 处 理 好 男 一 个 版 本 的 图 像 。 运 行 应 用 ,看 看 9-patch 新 图 是 什么 效果 ( 见 图 23-11 )。 
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图 23-11 9-patch 图 像 使 用 效果 


顶部 以 及 左边 框 标记 了 图 像 的 可 拉 伸 区 域 , 那么 底部 以 及 右边 框 又 该 如 何 处 理 呢 ?它们 定义 
了 9-patch 图 像 的 可 选 内 容 区 。 内 容 区 是 绘制 内 容 (通常 是 文字 ) 的 地 方 。 如 果 不 标记 内 容 区 , 那 
么 默认 与 可 拉 伸 区 域 保持 一 致 。 

使 用 内 容 区 让 按钮 上 的 文字 居中 。 现 在 继续 编辑 ic_button beat box _default.9.png， 如 图 23-12 
所 示 ， 在 图 片上 添加 上 右边 和 底部 两 条 线 。 同 时 勾 选 上 Show content 选 项 。 这 个 选项 会 让 预览 
高 亮 显示 图 片 的 文字 显示 区 。 
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图 23-12 ”定义 内 容 区 
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重复 上 述 步骤 处 理 好 另 一 个 版 本 的 图 像 。 仔 细 确 认 两 张 图 像 添 加 的 内 容 区 黑 线 都 正确 一 致 。 
state list drawable 使 用 9-patch 图 片 时 ( BeatBox 应 用 中 )， 内 容 区 可 能 会 有 非 预期 表现 。 按 钮 背景 
图 初始 化 时 ，Android 会 设置 内 容 区 内 容 ， 而 在 用 户 按 下 按钮 时 ， 内 容 区 内 容 很 可 能 不 会 有 变化 。 
这 说 明 ， 两 张 之 中 有 一 张 图 片 的 内 容 区 未 定义 。 所 以 ， 这 时 就 要 检查 看 看 ，state list drawable 使 
用 的 所 有 9-patch 图 片 是 否 都 有 相同 的 内 容 区 。 

运行 BeatBox 应 用 ， 可 以 看 到 文字 都 居中 显示 了 ， 如 图 23-13 所 示 。 
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图 23-13 ”BeatBox 应 用 新 面貌 


试 着 横 屏 查看 应 用 。 可 以 看 到 ， 图 像 拉 伸 得 更 厉害 了 ,不 过 按钮 背景 图 的 效果 依然 不 错 , 文 
字 依 然 能 居中 显示 。 


23.8 ”挑战 练习 : 按钮 主题 


完成 应 用 9-patch 图 片 更 新 后 , 你 可 能 已 注意 到 按钮 的 背景 图 有 点 不 对 劲 : 图 片 折 角 后 面 似乎 
有 阴影 。 你 甚至 还 注意 到 ， 只 有 在 Lollipop 或 更 高 系统 版 本 上 运行 应 用 时 ， 图 片 折 角 后 面 才 会 出 
现 阴 影 。 

实际 上 , 这 个 阴影 是 按钮 默认 在 Lollipop 或 更 高 系统 版 本 获得 的 一 种 浮 层 效果 。 按 下 按钮 时 ， 
它 会 向 你 的 手指 靠拢 ( 详 见 第 35 章 )。 

现在 , 不 替换 背景 图 ， 去 掉 这 个 阴影 。 回 顾 前 面 学 的 主题 相关 知识 ,看 看 这 个 阴影 是 怎么 产 
生 的 。 再 思考 思考 : 要 解决 这 个 问题 有 没有 其 他 按钮 样式 可 用 (作为 BeatBoxButton 样 式 的 父 
样式 ) ? 
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本 章 将 使 用 隐 式 intent 创 建 一 个 替换 Android 默 认 局 动 器 的 应 用 。 新 建 应 用 名 为 NerdLauncher， 


运行 画面 如 图 24-1 所 示 。 
A700 


API Demos 
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图 24-1 NerdLauncher 应 用 最 终 效果 
NerdLauncher 应 用 能 列 出 设备 上 的 其 他 应 用 。 点 选任 意 列表 项 会 启动 相应 应 用 。 
完成 该 应 用 能 帮 你 深入 理解 intent 、intent 过 滤器 ， 搞 清楚 Android 应 用 间 是 如 何 交 互 的 。 





























24.1 创建 NerdLauncher 项 目 


创建 一 个 Android 新 项 目 , 取 名 为 NerdLauncher。 选 择 Phone and Tablet 作 为 目标 设备 ,最 低 SDK 
版 本 设 为 API 19: Android 4.4 (KitKat)。 新 建 名 为 NerdLauncherActivity 的 空 activity。 

NerdLauncherActivity 需 要 托管 fragment， 所 以 它 也 应 继承 SingleFragmentActivity 类 。 找 
到 CriminalIntent 项 目 中 的 SingleFragmentActivity.java 和 activity fragment.xml 文 件 ， 把 它们 复制 到 
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NerdLauncher 应 用 项 目 中 备用 。 

打开 NerdLauncherActivityjava 文 件 ， 修 改 NerdLauncherActivity 的 超 类 为 SingteFragment- 
Activity 类 。 然 后 删除 默认 的 模板 代码 ,并 覆盖 createFragment () 方 法 返回 一 个 NerdLauncher- 
Fragment ， 如 代码 清单 24-1 所 示 。( createFragment () 方 法 会 报错 。 和 暂时 忽略 ， 稍 后 会 创建 
NerdLauncherFragment 类 解决 。) 





代码 清单 24-1 男 一 个 SingleFragmentActivity (NerdLauncherActivityjava ) 
public class NerdLauncherActivity extends SingleFragmentActivityAppCompatActivity { 


@Override 
protected Fragment createFragment() { 
return NerdLauncherFragment.newInstance(); 


} 


At Autoe-generated template code... */ 
} 
按照 第 8 章 所 述 方法 ,添加 RecyclerView 依 赖 项 ， 因 为 NerdLauncherFragment 要 用 它 显 示 
应 用 列表 。 
为 创建 fagment 布 局 , 重 命名 layout/activity_nerd launcherxml 为 layout/fragment nerd launcher. 
xml， 然 后 用 图 24-2 中 的 RecyclerView 蔡 换 原 布局 内 容 。 





android.support.v7.widget.RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/app_recycler_view" 


android: layout_width="match_parent" 


android: layout_height="match_parent" 








图 24-2 ”创建 NerdLauncherFragment 布 局 (layout/fragment_nerd launcher.xml ) 


最 后 ,以 android.support.v4.app.Fragment 为 父 类 ,创建 一 个 名 为 NerdLauncherFragment 
的 新 类 。 在 新 建 类 中 ， 新 增 newInstance() 方 法 ,覆盖 onCreateView(,.. ) 方 法 。 在 覆盖 方法 
中 , 将 RecyclerView 对 象 存放 在 mRecyctlerView 成 员 变 量 中 , 如 代码 清单 24-2 所 示 。( 稍 后 会 处 
理 RecycterView 的 数据 绑 定 。) 








Ey 





代码 清单 24-2 NerdLauncherFragment 初 始 类 ( NerdLauncherFragment.java ) 


public class NerdLauncherFragment extends Fragment { 
private RecyclerView mRecyclerView; 


public static NerdLauncherFragment newInstance() { 
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return new NerdLauncherFragment () ; 


} 


@Override 
public View onCreateView(LayoutInfLater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment nerd launcher, container, false); 
mRecyclerView = (RecyclerView) v.findViewById(R.id.app_recycler view); 
mRecyclerView. setLayoutManager (new LinearLayoutManager (getActivity())); 


return v; 


} 
运行 应 用 。 一切 正常 的 话 ， 可 看 到 如 图 24-3 所 示 的 用 户 界 面 。RecyclerView 尚 未 绑 定 数据 ， 


现在 还 无 法 看 到 应 用 列表 。 
"Ad 7:00 








图 24-3 ”NerdLauncher 应 用 初始 界面 

















24.2 ”解析 隐 式 intent 


NerdLaucher 应 用 会 列 出 设备 上 的 可 启动 应 用 。( 可 启动 应 用 是 指点 击 主屏 幕 或 启动 器 界面 上 
的 图 标 就 能 打开 的 应 用 。) 要 实现 该 功能 ， 它 会 使 用 PackageManager 获 取 所 有 可 启动 主 activity。 
可 启动 主 activity 都 带 有 包含 MAIN 操 作 和 LAUNCHER 类 别 的 intent 过 滤器 。 在 之 前 项 目的 
AndroidManifest,xml 文 件 中 ， 你 已 见 过 这 种 intent 过 滤 需 : 


<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
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<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 


在 NerdLauncherFragment.java 中 ， 新 增 setupAdapter() 方 法 ， 然 后 在 onCreateView(...) 
方法 中 调用 它 。( 该 方法 最 终 还 会 创建 RecyclerView.Adapter 实 例 并 设置 给 RecyclerView 对 
象 。) 另外 ， 再 创建 一 个 隐 式 intent 并 从 PackageManager 那 里 获取 匹配 它 的 所 有 activity。 最 后 ， 
记录 下 PackageManager 返 回 的 activity 总 数 ， 如 代码 清单 24-3 所 示 。 














代码 清单 24-3” 癌 PackageManager 查 询 activity 总 数 ( NerdLauncherFragment.java ) 
public class NerdLauncherFragment extends Fragment { 
private static final String TAG = "NerdLauncherFragment"; 


private RecyclerView mRecyclerView; 


public static NerdLauncherFragment newInstance() { 
return new NerdLauncherFragment(); 


} 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


setupAdapter(); 
return v; 


} 


private void setupAdapter() { 
Intent startupIntent = new Intent(Intent.ACTION MAIN); 
startupIntent.addCategory(Intent .CATEGORY _ LAUNCHER); 


PackageManager pm = getActivity().getPackageManager(); 
List<ResolveInfo> activities = pm.queryIntentActivities(startupIntent, 0); 


Log.i(TAG, "Found " + activities.size() + " activities."); 


} 


运行 NerdLauncher 应 用 ， 在 LogCat 窗 口 ， 看 看 PackageManager 返 回 多 少 个 activity。 
在 CriminalIntent 应 用 中 ， 为 使 用 隐 式 intent 发 送 crime 报 告 ， 我 们 先 创建 隐 式 intent， 表 将 其 封 
装 在 选择 器 intent 中 ， 最 后 调用 startActivity(Intent) 方 法 发 送 给 操作 系统 : 


Intent i = new Intent(Intent.ACTION SEND); 

. // Create and put intent extras 

= Intent.createChooser(i, getString(R.string.send report)); 
startActivity(i); 


这 里 没有 使 用 上 述 处 理 方式 ， 是 不 是 很 费解 ? 原因 很 简单 : MAIN/LAUNCHER intent 过 滤器 
可 能 无 法 与 通过 startActivity(. , ) 方 法 发 送 的 MAIN/LAUNCHER 隐 急 式 intent 相 匹配 。 

事实 上 ,， sta RE Te ) 方 法 意味 着 “启动 匹配 隐 式 intent 的 默认 activity”"， 而 不 是 
想当然 的 “启动 匹配 隐 式 intent 的 activity”。 调用 startActivity(Intent) 方 法 (或 startActivity- 
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ForResult(...) 方 法 ) 发 送 隐 式 intent 时 ， 操 作 系 统 会 悄悄 为 目标 intent 添 加 Intent .CATEGORY 
DEFAULTz 类 别 。 

因此 ， 如 果 希 望 intent 过 滤器 匹配 startActivity(...) 方 法 发 送 的 隐 式 intent， 就 必须 在 对 
应 的 intent 过 滤 需 中 包含 DEFAULT 类 别 。 

定义 了 MAIN/LAUNCHER intent 过 滤器 的 activity 是 应 用 的 主要 入 口 点 。 它 只 负责 做 好 作为 应 
用 主要 入口 点 要 处 理 的 工作 。 它 通常 不 关心 自己 是 否 为 默认 的 主要 人 口 点 ， 所 以 可 以 不 包含 
CATEGORY_DEFAULT 类 别 。 

前 面 说 过 ，MAIN/LAUNCHER intent 过 滤器 并 不 一 定 包含 CATEGORY_DEFAULT 类 别 ， 因 此 不 
能 保证 可 以 与 startActivity(...,) 方 法 发 送 的 隐 式 intent 匹 配 。 所 以 ,我 们 转 而 使 用 intent 直 接 
向 PackageManage r 查询 带 有 MAIN/LAUNCHER intent 过 滤器 的 activity。 

接 下 来 , 需要 在 NerdLauncherFragment 的 RecycLerview 视 图 中 显示 查询 到 的 activity 标 签 。 
activity 标 签 是 用 户 可 以 识别 的 展示 名 称 。 既 然 查询 到 的 activity 都 是 启动 activity, 标签 名 通常 也 就 
是 应 用 名 。 

在 PackageManager 返 回 的 ResoLveInfo 对 象 中 ， 可 以 获取 activity 标 签 和 其 他 一 些 元 数据 。 

首先 ， 使 用 ResoLveInfo,LoadLabetL(PackageManager) 方 法 ， 对 ResoLveInfo 对 象 中 的 
activity 标 签 按 首 字母 排序 ， 如 代码 清单 24-4 所 示 。 


代码 清单 24-4 ”对 activity 标 签 排序 (NerdLauncherFragment.java ) 


public class NerdLauncherFragment extends Fragment { 






























































private void setupAdapter() { 


List<ResolveInfo> activities = pm.queryIntentActivities(startupIntent, 0); 
Collections.sort(activities, new Comparator<ResoLveInfo>() { 
public int compare(ResoLveInfo a, ResolveInfo b) { 
PackageManager pm = getActivity().getPackageManager(); 
return String.CASE INSENSITIVE ORDER.comparel( 
a.loadLabel (pm) .toString(), 
b.loadLabel (pm) .toString()); 
} 
}); 


Log.i(TAG, "Found " + activities.size() + " activities."); 


} 

然后 ,定义 一 个 ViewHolder 用 来 显示 activity 标 签名 。 男 外 ，ResolveInfo 信 息 经 常 要 用 ， 
里 使 用 成 员 变 量 存储 它 ， 如 代码 清单 24-5 所 示 。 
代码 清单 24-5 ”实现 ViewHolder (NerdLauncherFragment.java ) 


public class NerdLauncherFragment extends Fragment { 








这 











private void setupAdapter() { 


} 
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private class ActivityHolder extends RecyclerView.ViewHolder { 
private ResoLveInfo mResolveInfo; 
private TextView mNameTextView; 


public ActivityHoLder(View itemView) { 
super (itemView); 
mNameTextView = (TextView) itemView; 


} 


public void bindActivity(ResoLveInfo resoLveInfo) { 
mResoLveInfo = resolveInfo; 
PackageManager pm = getActivity().getPackageManager(); 
String appName = mResolveInfo.loadLabel (pm) .toString(); 
mNameTextView. setText (appName); 





} 
接 下 来 实现 RecyclerView.Adapter， 如 代码 清单 24-6 所 示 。 
代码 清单 24-6 ”实现 RecyclerView.Adapter (NerdLauncherFragment.java ) 


public class NerdLauncherFragment extends Fragment { 
private class ActivityHolder extends RecyclerView.ViewHolder { 


} 


private class ActivityAdapter extends RecyclerView.Adapter<ActivityHolder> { 
private final List<ResoLveInfo> mActivities; 


public ActivityAdapter(List<ResolveInfo> activities) { 
mActivities = activities; 


} 


@Override 
public ActivityHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
LayoutInfLater LayoutInfLater = LayoutInflater.from(getActivity()); 
View view = LayoutInfLater 
.infLate(android.R.Layout.simpLe list item 1, parent, false); 
return new ActivityHolder (view); 


} 


@Override 

public void onBindViewHolder(ActivityHolder holder, int position) { 
ResoLveInfo resoLveInfo = mActivities.get(position); 
hoLder.bindActivity(resoLveInfo) ; 

} 


@Override 
public int getItemCount() { 
return mActivities.size(); 


} 
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最 后 ， 更 新 setupAdapter() 方 法 , 创建 一 个 ActivityAdapter 实 例 并 配置 给 RecyclerView， 
如 代码 清单 24-7 所 示 。 


代码 清单 24-7 为 RecyclerView 设 置 adapter ( NerdLauncherFragment.java ) 


public class NerdLauncherFragment extends Fragment { 








private void setupAdapter() { 


Log.i(TAG, "Found " + activities.size() + " activities."); 
mRecyclerView.setAdapter (new ActivityAdapter(activities)); 


} 


运行 NerdLauncher 应 用 。 现 在 可 以 看 到 显示 了 activity 标 签 的 RecycLerView 视 图 ， 如 图 24-4 
所 示 。 











NerdLauncher 
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Docs 


Downloads 


Drive 





图 24-4 ”设备 上 的 全 部 activity 


24.3 ”在 运行 时 创建 显 式 intent 


上 一 节 ， 我 们 使 用 隐 式 intent 获 取 目 标 activity 并 以 列表 的 形式 展示 。 接 下 来 要 实现 点 击 任 一 
列表 项 时 ， 启 动 对 应 的 activity。 这 次 ， 我 们 需要 使 用 显 式 intent 来 启动 activity。 
要 创建 启动 activity 的 显 式 intent， 需 要 从 ResotveInfo 对 象 中 获取 activity 的 包 名 与 类 名 。 这 
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些 信息 可 以 从 ResolveInfo 对 象 的 ActivityInfo 中 获取 。( 从 ResolveInfo 类 中 还 可 以 获取 其 
他 信息 , 具体 请 查阅 该 类 的 参考 文档 : developer.android.com/reference/android/content/pm/Resolve- 
Info.html。) 

更 新 ActivityHotLder 类 实施 一 个 点 击 监听 器 。 然 后 ,使 用 ActivityInfo 对 象 中 的 数据 信息 ， 
创建 一 个 显 式 intent 并 启动 目标 activity， 如 代码 清单 24-8 所 示 。 


代码 清单 24-8 启动 目标 activity ( NerdLauncherFragment.java ) 


private class ActivityHolder extends RecyclerView.ViewHolder 
impLements View.OnClickListener { 
private ResolveInfo mResolveInfo; 
private TextView mNameTextView; 








public ActivityHolder(View itemView) { 
super (itemView); 
mNameTextView = (TextView) itemView; 
mNameTextView.setOnClickListener(this); 
} 


public void bindActivity(ResolveInfo resolveInfo) { 


} 


@Override 
public void onClick(View v) { 
ActivityInfo activityInfo = mResolveInfo.activityInfo; 


Intent i = new Intent(Intent.ACTION MAIN) 
.SetClassName(activityInfo.applicationInfo.packageName, 
activityInfo.name); 


startActivity(i); 

















， 作 为 显 式 intent 的 一 部 分 ， 我们 还 发 送 了 ACTION_MAIN 操 作 。 发 送 的 intent 是 否 包 含 操 

作 ， FA 用 来 说 没有 什么 差别 。 不过， 有 些 应 用 的 启动 行为 可 能 会 有 所 不 同 。 取 决 于 不 
同 的 启动 要 求 ， 同 样 的 activity 可 能 会 显示 不 同 的 用 户 界面 。 开 发 人 员 最 好 能 明确 启动 意图 ， 以便 
让 activity 完 成 它 应 该 完成 的 任务 。 

在 代码 清单 24-8 中 ， 使 用 包 名 和 类 名 创建 显 式 intent 时 ， 我 们 使 用 了 以 下 Intent 方 法 : 

public Intent setClassName(String packageName, String className) 

这 不 同 于 以 往 创建 显 式 intent 的 方式 。 之 前 ， 我 们 使 用 的 是 接受 Context 和 Class 对 象 的 
Intent 构 造 方 法 : 

public Intent(Context packageContext, Class<?> cls) 


该 构造 方法 使 用 传人 的 参数 来 获取 Intent 需 要 的 ComponentName。ComponentName 由 包 名 
和 类 名 共同 组 成 。 传 人 Activity 和 CLass 创 建 Intent 时 ， 构 造 方法 会 通过 Activity 类 自行 确定 
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全 路 径 包 名 。 
也 可 以 自己 通过 包 名 和 类 名 创建 ComponentName ， 然 后 使 用 下 面 的 Intent 方 法 创建 显 式 
intent : 


public Intent setComponent (ComponentName component ) 


不 过 ，setClassName( 
运行 NerdLauncher 应 月 


24.4 
应 月 


. ) 方 法 能 够 自动 创建 组 件 名 ， 用 它 可 以 少 写 
试 启动 一 些 应 用 。 





并 党 
任务 与 回 退 栈 
有 运行 时 ，Android 使 用 任务 来 跟踪 用 户 的 状态 。 通 过 Android 默 认 启 动 髓 














都 有 自己 的 任务 。 然 而 ， 这 并 不 适用 于 NerdLaucher 应 用 。 在 NerdLaucher 应 用 中 启动 的 应 月 








不 少 代码 呢 。 


应 用 打开 的 应 用 









































上 怎样 

















获得 这 样 的 行为 呢 ?” 别 着 急 ， 我 们 先 来 搞 清 楚 究 竞 什么 是 任务 ， 它 是 如 何 工作 的 。 

人 activity 栈 。 栈 底部 的 activity 通 常 称 为 基 activity。 栈 顶 的 activity 用 户 能 看 得 到 。 如 
果 按 后 退 键 ， 栈 顶 activity 会 弹出 栈 外 。 如 果 用 户 看 到 的 是 基 activity， 按 后 退 键 ， 系 统 就 会 回 到 主 
屏幕 。 

默认 情况 下 ， 新 activity 都 在 当前 任务 中 启动 。 在 CriminalIntent 应 用 中 ， 无 论 何 时 启动 新 





activity， 它 都 会 被 添加 到 当前 任务 中 。 即 使 要 启动 的 activity 不 属于 CriminalIntent 应 月 
它 同样 也 在 当前 任务 中 启动 。 如 图 24-5 所 示 。 
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图 24-5 CriminalIntentf 


动 activity 的 好 处 是 , 用 





在 当前 任务 中 局 
24-6 所 示 。 
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按 下 CHOOSE 
SUSPECT 按 钮 


王 务 
有 户 可 以 在 任务 内 而 不 是 在 应 用 层级 间 导 航 返 回 , 如 图 
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24.4.1 在 任务 间 切 换 


在 不 影响 各 个 任务 状态 的 情况 下 ，overview screen 可 以 让 我 们 在 任务 间 切 换 ( 第 3 章 已 初 识 )。 
例如 ， 一 开始 你 在 录 联 系 人 信息 ， 然 后 转 到 Twitter 应 用 看 信息 ， 这 时 就 启动 了 两 个 任务 。 如 果 再 
回 到 联系 人 应 用 ， 你 在 两 个 任务 中 所 处 的 操作 状态 都 会 被 保存 下 来 。 

耳闻 不 如 亲 见 ， 你 可 以 在 设备 或 模拟 器 上 试 斌 overview screen。 首 先 ， 从 主屏 幕 或 应 用 启动 
器 中 启动 CriminalIntent 应 用 。( 如 果 已 缉 载 , 请 打开 Android Studio 中 的 CriminalIntent 项 目 并 运行 。) 
从 crime 列 表 中 选择 任意 列表 项 ， 然 后 ， 按 主屏 幕 键 回 到 主屏 幕 。 接 着 ， 从 主屏 幕 或 应 用 启动 器 
中 启动 BeatBox 应 用 。 

现在 ， 按 Recents 按 钮 打开 overview screen， 如 图 24-7 所 示 。 
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图 24-7 ”overview Screen 的 不 同 版 本 


如 果 是 KitKat 设 备 ， 用 户 会 看 到 图 24-7 左 边 的 overview screen; 如 果 是 Lollipop ， 会 看 到 右边 
的 overview screen。 不 管 怎样 ， 图 中 的 每 个 应 用 显示 项 ( 就 是 Lollipop 系 统 所 说 的 卡片 ) 就 代表 着 
一 个 应 用 任务 。 当 前 任务 显示 的 是 处 于 回 退 栈 顶 部 activity 的 快照 。 你 可 以 点 击 任意 显示 项 切换 至 
对 应 应 用 的 当前 activity。 

要 清除 应 用 任务 ,用户 只 需 滑动 移 除 卡片 即 可 。 清 除 任务 会 从 应 用 回 退 栈 中 清除 所 有 activity。 

试 着 清除 CriminalIntent 应 用 任务 再 重启 。 重 启 后 ,你 看 到 的 是 crime 列 表 界 面 ， 而 不 应 再 是 清 
除 前 的 crime 编 辑 界面 了 。 

































































24.4.2 ”启动 新 任务 
有 时 你 需要 在 当前 任务 中 启动 activity， 而 有 时 又 需要 在 新 任务 中 启动 activity。 
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当前 ， 从 NerdLauncher 启 动 的 任何 activity 都 会 添加 到 NerdLauncher 任 务 中 ， 如 图 24-8 所 示 。 























图 24-8 NerdLauncher 任 务 中 包含 CriminalIntent 应 用 activity 


要 想 确 认 这 点 ， 可 先 清除 overview screen 显 示 的 所 有 任务 。 然 后 ， 启 动 NerdLauncher 并 点 击 
CriminalIntent 列 表 项 启动 CriminalIntent 应 用 。 再 次 打开 overview Donate 面 时 ， 应 该 看 不 到 
CriminalIntent 任 务 了 。CrimeListActivity 启 动 后 ， 它 随即 就 添加 到 NerdLauncher 任 务 中 了 ， 如 
图 24-9 所 示 。 只 要 点 击 NerdLauncher 任 务 ， 你 就 会 回 到 启动 overview screen 界 面 之 前 所 在 的 
CriminalIntent 用 户 界面 。 
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图 24-9 ”CriminalIntent 应 用 在 NerdLauncher 任 务 中 





我 们 需要 NerdLauncher 在 新 任务 中 启动 activity， 如 图 24-10 所 示 。 这 样 ， 点 击 NerdLauncher 
启动 需 中 的 应 用 项 可 以 让 应 用 拥有 自己 的 任务 ， 用 户 就 可 以 在 运行 的 应 用 间 自 由 切换 了 。 
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图 24-10 ”让 CriminalIntent 在 自身 任务 里 启动 
为 了 在 启动 新 activity 时 启动 新 任务 ， 需 要 为 intent 添 加 一 个 标志 ， 如 代码 清单 24-9 所 示 。 


代码 清单 24-9 ”为 intent 添 加 新 任务 标志 ( NerdLauncherFragment.java ) 


public class NerdLauncherFragment extends Fragment { 











private class ActivityHolder extends RecyclerView.ViewHolder 
implements View.OnClickListener { 
GOverride 
public void onClick(View v) { 
Intent i = new Intent(Intent.ACTION MAIN) 
.SetClassName(activityInfo.applicationInfo.packageName, 


activityInfo.name) 
.addFlags (Intent.FLAG ACTIVITY_ NEW_ TASK); 


startActivity(i); 


上 


先 清除 overview screen 显 示 的 所 有 任务 ， 再 次 运行 NerdLauncher 应 用 并 启动 CriminalIntent。 
这 次 ， 如 果 启 动 overview screen， 就 会 看 到 CriminalIntent 应 用 处 于 一 个 单独 的 任务 中 ， 如 图 24-11 
所 示 。 

如 果 从 NerdLauncher 应 用 中 再 次 启动 CriminalIntent 应 用 ， 也 不 会 创建 第 二 个 CriminalIntent 任 
务 。FLAG ACTIVITY_NEW_TASK 标 志 控 制 每 个 activity 仅 创建 一 个 任务 。CrimeListActivity 已 经 有 
了 一 个 运行 的 任务 ， 因 此 Android 会 自动 切换 到 原来 的 任务 ， 而 不 是 创建 全 新 的 任务 。 

眼见 为 实 。 在 CriminalIntent 应 用 中 ， 打 开 任 意 crime 的 明细 界面 。 然 后 ， 使 用 overview screen 
切换 至 NerdLauncher。 点 击 应 用 列表 中 的 CriminalIntent。 可 以 看 到 ，CriminalIntent 应 用 中 打开 的 
crime 明 细 界 面 又 回来 了 。 
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图 24-11 ”CriminalIntent 应 用 处 于 独立 的 任务 


24.5 ”使 用 NerdLauncher 应 用 作为 设备 主屏 幕 


没 人 愿意 通过 启动 一 个 应 用 来 启动 其 他 应 用 。 因 此 ， 以 替换 Android 主 界面 (home screen ) 
的 方式 使 用 NerdLauncher 应 用 会 更 合适 一 些 。 打 开 NerdLauncher 项 目的 AndroidManifest. xml， 问 
intent 主 过 滤器 添加 以 下 节点 定义 ， 如 代码 清单 24- 10 所 示 。 


代码 清单 24-10 ”修改 NerdLauncher 应 用 的 类 别 ( AndroidManifest.xml ) 


<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
<category android:name="android.intent.category.HOME" /> 
<category android:name="android.intent.category .DEFAULT" /> 
</intent-filter> 


添加 HOME 和 DEFAULT 类 别 定义 后 ，NerdLauncher 应 用 的 activity 会 成 为 可 选 的 主 界面 。 按 主屏 
幕 键 可 以 看 到 ， 在 弹出 的 对 话 框 中 ，NerdLauncher 变 成 了 主 界 面 可 选项 ， 如 图 24-12 所 示 。 

( 如 果 已 设置 NerdLauncher 应 用 为 主 界面 ,恢复 系统 默认 设置 也 很 容易 。 首 先 ,从 NerdLauncher 
启动 Settings 应 用 。 如 果 是 Lollipop 系 统 ， 可 选择 Settings 一 Apps 菜 单项 ， 然 后 从 应 用 列表 中 选择 
NerdLauncher。 如 果 是 Lollipop 之 前 的 系统 , 可 以 选择 Settings 一 Applications 一 Manage Applications 
菜单 项 ， 找 到 NerdLauncher 应 用 。 选 择 了 NerdLauncher 后 ， 在 应 用 的 信息 屏 ， 滚 动 到 Launch by 
default 并 点 击 CLEAR DEFAULTS 按 钮 。 好 了 ， 下 次 再 按 主 屏幕 键 时 ， 又 可 以 自主 选 了 。 ) 
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含 ”Launcher3 


全 NerdLauncher 

















图 24-12 ”选择 主屏 幕 应 用 








24.6 ”挑战 练习 : 应 用 图 标 


前 面 , 为 在 启动 器 应 用 中 显示 各 个 activity 的 名 称 , 你 使 用 了 ResolveInfo.loadLabel(...) 
方法 。loadIcon() 是 ResolveInfo 类 的 男 一 个 方法 ， 可 以 用 它 为 每 个 应 用 加 载 显 示 图 标 。 作 为 
练习 ， 请 给 NerdLauncher 应 用 中 显示 的 所 有 应 用 添加 图 标 。 


24.7 深入 学 习 : 进程 与 任务 


对 象 需 要 内 存 和 虚拟 机 的 支持 才能 生存 。 进 程 是 操作 系统 创建 的 、 供 应 用 对 象 生存 以 及 应 用 
运行 的 地 方 。 

进程 通常 会 占用 由 操作 系统 管理 着 的 系统 资源 ， 如 内 存 、 网 络 端口 以 及 打开 的 文件 等 。 进 程 
还 拥有 至 少 一 个 〈 可 能 多 个 ) 执行 线程 。 在 Android 系 统 中 ， 每 个 进程 都 需要 一 个 虚拟 机 来 运行 。 

尽管 存在 未 知 的 异常 情况 ,但 总 的 来 说 ，Android 志 界 里 的 每 个 应 用 组 件 都 仅 与 一 个 进程 相 
关联 。 应 用 伴随 着 自己 的 进程 一 起 完成 创建 ， 该 进程 同时 也 是 应 用 中 所 有 组 件 的 默认 进程 。 

(虽然 组 件 可 以 指派 给 不 同 的 进程 ， 但 我 们 推荐 使 用 默认 进程 。 如 果 确 实 需要 在 不 同 进 程 中 
运行 应 用 组 件 ， 通 常 也 可 以 借助 多 线程 来 实现 。 相 比 多 进程 的 使 用 ，Android 多 线程 的 使 用 更 加 
简单 。) 

每 一 个 activity 实 例 都 仅 存在 于 一 个 进程 之 中 , 同一 个 任务 关联 。 这 也 是 进程 与 任务 的 唯一 相 
似 之 处 。 任 务 只 包含 activity， 这 些 activity 通 常 来 自 于 不 同 的 应 用 进程 ;而 进程 则 包含 了 应 用 的 全 
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部 运行 代码 和 对 象 。 


进程 与 任务 很 容易 让 人 混淆 ,主要 原因 在 于 它们 不 仅 在 概念 上 有 某 种 重 琶 ,而 且 通 常会 被 人 
以 应 用 名 提 及 。 例 如 ， 从 NerdLauncher 启 动 器 中 启动 CriminalIntent 应 用 时 ， 操 作 系 统 创 建 了 一 个 
CriminalIntent 进 程 以 及 一 个 以 CrimeListActivity 为 基 栈 activity 的 新 任务 。 在 overview screen 中 ， 


可 以 看 到 这 个 任务 就 被 标 名 为 CriminalIntent。 


包含 activity 的 任务 和 它 赖 以 生存 的 进程 有 可 能 会 不 同 。 以 CriminalIntent 应 用 和 联系 人 应 用 为 


例 ， 看 看 以 下 具体 场景 就 会 明白 了 。 





打开 CriminalIntent 应 用 ， 选 择 任意 crime 项 (或 添加 一 条 crime 记 录 )， 然 后 点 击 CHOOSE 
SUSPECT 按 钮 。 这 会 打开 联系 人 应 用 让 你 选择 目标 联系 人 人。 随即， 联系 人 列表 activity 会 被 加 入 
CriminalIntent 应 用 任务 中 。 如 果 此 时 按 后 退 键 在 不 同 activity 间 切换 的 话 ， 用 户 可 能 意识 不 到 他 们 











正在 进程 间 切 换 。 








用 总 JI 入 





然而 , 联系 人 activity 实 例 实际 是 在 联系 人 应 用 进程 的 内 存 空间 创建 的 , 而 且 也 是 在 该 应 用 进 


程 里 的 虚拟 机 上 运行 的 ， 如 图 24-13 所 示 。 
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Activity 











CrimeList 
Activity 实 例 


CrimeActivity 
实例 


(Contacts 应 用 进程 ) 


Contact List 
Activity 实 例 





图 24-13 ”任务 与 进程 一 对 多 的 关系 


(CriminalIntent 应 用 进程 ) 
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为 进一步 了 解 进程 和 任务 的 概念 ， 让 CriminalIntent 应 用 运行 着 ， 进 入 联系 人 列表 界面 。( 继 
续 之 前 ， 请 确保 在 overview screen 里 看 不 到 联系 人 应 用 。) 按 主屏 幕 键 回 到 主屏 幕 ， 从 中 启动 联系 


人 应 用 。 然 后 从 联系 人 列表 选取 任意 联系 人 ， 
在 这 个 操作 过 程 中 , 系统 会 在 联系 人 应 用 





面 实例 。 也 会 创建 联系 人 应 用 新 任务 。 这 个 者 





实例 ， 如 图 24-14 所 示 。 







CrimeListActivity 


Contact List 
Activity 





Contact List 
Activit 


Contact Details 
Activity 








或 添加 新 联系 人 。 
进程 中 创建 新 的 联系 人 列表 activity 和 联系 人 明细 界 








所 任务 会 引用 联系 人 列表 和 联系 人 明细 界面 activity 
















(CriminalIntent 


应 用 进程 ) 





CrimeList 
Activity 实 例 
CrimeActivity 
实例 





(Contacts 应 用 进程 ) 


Contact List 
Activity 实 例 











Contact List 
Activity 实 例 


Contact Details 
Activity 实 例 






图 24-14 ”进程 对 多 个 任务 





本 章 ， 我 们 创建 了 任务 并 实现 了 任务 间 的 切换 。 有 没有 想 过 替换 Android 默 认 的 overview 
screen 呢 ?很 遗憾， 做 不 到 ，Android 没 告诉 我 们 怎么 做 。 男 外 ， 你 应 该 知道 ，Google Play 商店 中 
那些 自称 为 任务 终止 器 的 应 用 ， 实 际 上 都 是 进程 终止 器 。 
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如 果 是 在 Lollipop 设 备 上 运行 CriminalIntent 迟 用， 打开 overview screen 查 看 任务 时 ， 你 会 发 现 
一 些 有 趣 的 现象 。 例 如 ， 在 发 送 crime 消 息 时 ， 你 所 选择 发 送 消息 应 用 的 activity 不 会 添加 到 
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Criminalmtent 应 用 任务 中 ， 而 是 添加 到 它 自己 的 独立 任务 中 ， 如 图 24-15 所 示 。 


AR 2:00 


From bnrdevice@gmail.com 
To 


Criminalintent Crime Report 


somebody stole my yogurt! The crime 
was discovered on Fri, Apr 17. The case 
is not solved, and there is no suspect. 








图 24-15”Gmail 处 于 独立 的 任务 中 


在 Lollipop 设 备 上 ， 对 以 android.intent.action.SEND 或 action.intent.action.SEND 
MULTIPLE 启 动 的 activity， 隐 式 intent 选 择 器 会 创建 独立 的 新 任务 。( 在 旧 设 备 上 ，Gmail 的 activity 
直接 添加 给 了 CriminalIntent 应 用 任务 。) 

这 种 现象 要 归 因 于 Lollipop 中 叫 作 并 发 文档 ( concurrent document ) 的 新 概念 。 有 了 并 发 文档 ， 
就 可 以 为 运行 的 应 用 动态 创建 任意 数目 的 任务 。 在 Lollipop 之 前 ， 应 用 任务 只 能 预先 定义 好 ， 而 
且 还 要 在 manifest 文 件 中 指明 。 

Google Drive 就 是 并 发 文档 概念 应 用 的 最 好 实例 。 用 户 可 以 用 它 打开 并 编辑 多 份 文档 。 这 些 
文档 编辑 activity 都 处 在 独立 的 任务 中 ， 如 图 24-16 所 示 。 在 Lollipop 之 前 的 设备 上 查看 overview 
screen 的 话 ， 你 只 能 看 到 孤零零 的 一 个 任务 。 前 面 已 说 过 ，Lollipop 之 前 的 系统 需要 在 manifest 中 
提前 定义 应 用 任务 ， 所 以 系统 无 法 为 单个 应 用 动态 创建 多 个 任务 。 

在 Lollipop 设 备 上 ， 如 果 和 需要 应 用 启动 多 个 任务 ， 可 采用 两 种 方式 : 给 intent 打 上 Intent. 
FLAG ACTIVITY_NEW _DOCUMENT 标 签 ， 青 调用 startActivity(...) 方 法 ; 或 者 在 manifest 文 件 
中 ， 为 activity 设 置 如 下 documentLaunchMode: 


<activity 
android:name=".CrimePagerActivity" 
android:label="@string/app_name" 
android:parentActivityName=".CrimeListActivity" 
android:documentLaunchMode="intoExisting" /> 
































24.8 深入 学 习 : 并 发 文档 397 





Goosle 


转 wyAndroidEssay 


Android is awesome. 


[=| Funding Request 


Dear mom, 


Please send money so | can buy more food. 
1 promise | won't buy beer. 


Drive 


Files 





目 Funding Request 
一 Modified: 4:3n.nM 








图 24-16 ”Lollipop 设 备 上 的 多 个 Google Drive 任 务 


使 用 上 述 方法 ， 一 份 文档 只 会 对 应 一 个 任务 。( 如 果 发 送 带 有 和 已 存在 任务 相同 数据 的 
intent ， 系 统 就 不 会 再 创建 新 任务 。) 如 果 无 论 如 何 都 想 创建 新 任务 ， 那 就 给 intent 同 时 打上 
Intent .FLAG_ACTIVITY NEW DOCUMENT 和 Intent.FLAG ACTIVITY MU LTIPLE_ TASK 标签 ,或 
者 把 manifest 文 件 中 的 documentLaunchMode 属 性 值 改 为 always。 

想 要 深入 了 解 overview screen 或 者 想 知道 Lollipop 系 统 相 较 旧 系 统 有 哪些 变化 ， 请 访问 网 页 


developer.android.com/guide/components/recents.html。 














HTTP 与 后 台 任 务 








言 息 时 代 ， 互 联网 应 用 占用 了 用 户 的 大 量 时间 。 和 餐桌 上 无 人 交谈 ,每 个 人 都 只 顾 低头 摆弄 手 
机 。 一 有 了 时间， 人 们 就 查看 新 闻 推 送 、 收 发 短信 息 ， 或 是 玩 网 络 游戏 。 

为 学 习 Android 网 络 应 用 的 开发 , 我 们 来 创建 一 个 名 为 PhotoGallery 的 应 用 。PhotoGallery 是 图 
片 共 享 网 站 Flickr 的 一 个 客户 端 应 用 ， 它 能 获取 并 展示 Flickr 网 站 的 最 新 公共 图 片 。 应 用 的 最 终 运 





行 效果 如 图 25-1 所 示 。 


PhotoGallery 























A770 


(© STARTPOLLING 














图 25-1 ”PhotoGallery 应 用 最 终 效果 


(PhotoGallery 应 用 有 过 滤 功 能 ， 只 能 








示 无 版 权限 带 





0 


图 
1 图 片 。 可 访问 网 址 www.flickr 








com/commons/usage/， 进 一 步 了 解 非 限制 使 用 图 片 。Flickr 网 站 上 有 很 多 图 片 归 上 传 者 私有 , 使 用 
它们 需 遵守 使 用 许可 限制 条 款 。 可 访问 网 址 www.ftickrcomycreativecommons/， 了 解 更 多 有 关 第 三 
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方 内 容 的 使 用 权限 问题 。) 

接 下 来 的 六 章 我 们 都 会 学 习 开 发 PhotoGallery 应 用 。 前 两 章 学 习 网 络 下 载 、JSON 文 件 解析 、 
图 像 显示 等 基本 知识 。 随 后 的 几 章 里 ， 会 为 应 用 添加 一 些 特色 功能 ， 并 借 此 学 习 搜 索 、 服 务 、 通 
知 、 广 播 接 收 器 以 及 网 页 视图 等 知识 。 

本 章 ， 我 们 首先 学 习 应 用 级 HTTP 网 络 编程 。 当 前 ， 几 乎 所 有 网 络 服务 的 开发 都 是 以 HTTP 
网 络 协议 为 基础 的 。 本 章 结束 时 ， 你 应 完成 的 任务 是 : 获取 、 解 析 以 及 显示 Flickr 图 片 的 标题 ， 
如 图 25-2 所 示 。( 第 26 章 会 学 习 图 片 获取 与 显示 的 相关 内 容 。 ) 
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图 25-2 ”本 章 结束 时 的 应 用 效果 图 





25.1 创建 PhotoGallery 应 用 


按照 图 25-3 所 示 的 配置 , 创建 一 个 全 新 的 Android 应 用 项 目 (目标 设备 选 Phone and Tablet, 最 
低 SDK 版 本 选 API 19 )。 

单 击 Next 按 钮 ， 让 应 用 向 导 创建 一 个 名 为 PhotoGalleryActivity 的 空 activity。 

PhotoGallery 应 用 继续 沿用 前 面 一 直 使 用 的 设计 架构 。 计 PhotoGalleryActivity 继 承 
SingleFragmentActivity， 其 视图 为 activity fragment.xml 中 定义 的 容器 视图 。 它 会 负责 托管 稍 
后 会 创建 的 PhotoGaLLeryFragment 实 例 。 

从 之 前 项 目 将 SingleFragmentActivity.java 和 activity fragment.xml 复 制 到 当前 项 目 中 备用 。 
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@"e® Create New Project 





Android Studio 


bx New Project 
4 
Configure your new project 


Application name: | PhotoGallery 
Company Domain: | android.bignerdranch.com 


Package name: com.bignerdranch.android.photogallery 


中 


Include C++ Support 


Project location' /Users/dev/AndroidStudioProjects/PhotoGallery 


Cancel Previous .2 Finish 














二 





图 25-3 ”创建 PhotoGallery 应 





在 PhotoGalleryActivityjava 中 ,删除 工具 自动 产生 的 模板 代码 ,然后 ,让 PhotoGalleryActivity 
继承 SingleFragmentActivity， 并 实现 它 的 createFragment() 方 法 。createFragment() 方 法 
将 返回 一 个 PhotoGalleryFragment 类 实例 , 如 代码 清单 25-1 所 示 。( 有 错误 提示 没关系 , 稍 后 创 
建 完 PhotoGaLLeryFragment 类 就 好 了 。) 


代码 清单 25-1 activity 的 调整 ( PhotoGalleryActivity.java ) 
public class PhotoGalleryActivity extends Activity SingleFragmentActivity { 


@Override 
protected Fragment createFragment() { 
return PhotoGalleryFragment.newInstance(); 





PhotoGallery 应 用 会 在 RecyclerView 视 图 (借助 其 内 置 的 6ridLayoutManager ) 中 显示 网 格 
内 容 。 

首先 是 添加 RecyclerView 依 赖 项 。 打 开 项 目 结构 窗口 ， 选 择 左 边 的 app 模 块 。 青 选择 
Dependencies 选 项 页 ， 单 击 + 按钮 。 在 随后 出 现 的 下 拉 菜 单 中 选择 Library dependency。 找 到 并 选 
择 recyclerview-v7 后 点 击 OK 按 钮 完成 。 
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为 创建 fragment 布 局 ， 重 命名 layout/activity photo_gallery.xml 为 layout/fragment photo_ 


gallery.xml。 然 后 以 图 25-4 所 示 的 RecyclerView 组 件 定义 蔡 换 原 内 容 。 








android.support.v7.widget.RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/photo_recycler_view" 
android: layout_width="match_parent" 


android: layout_height="match_parent" 


tools:context="com.bignerdranch.android.photogallery.PhotoGalleryActivity" 








图 25-4 RecyclerView 视 图 (layout/fragment photo_ gallery.xml ) 


最 后 ,创建 PhotoGalleryFragment 类 ,设置 其 为 保留 fagment， 实 例 化 生成 新 建 布局 并 引 





用 RecyclerView 视 图 ， 如 代码 清单 25-2 所 示 。 


代码 清单 25-2 ”一 些 代码 片断 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
private RecyclerView mPhotoRecyclerView; 


public static PhotoGalleryFragment newInstance() { 
return new PhotoGalleryFragment(); 
} 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setRetainInstance(true); 


} 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment photo_ gallery, container, false); 


mPhotoRecyclerView = (RecyclerView) v.findViewById(R.id.photo_recycler view); 
mPhotoRecyclerView.setLayoutManager (new GridLayoutManager (getActivity(), 3)); 


return v; 


} 


(知道 为 什么 要 保留 人 agment 吗 ? 自己 先 思 考 一 下 ， 答 案 会 在 25.7 节 揭晓 。 
继续 之 前 ， 试 着 运行 PhotoGallery 应 用 。 2 可 以 看 到 一 个 空白 视图 。 
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PhotoGallery 应 用 中 ， 我 们 需要 一 个 网 络 连 接 专 用 类 。 应 用 要 访问 的 是 Flickr 网 站 ， 因 此 新 建 
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一 个 名 为 FLickrFetchr 的 Java 类 。 

FLickrFetchr 类 一 开始 只 有 getUrLBytes(String) 和 getUrLString(String) 两 个 方法 。 
getUrLBytes (String) 方 法 能 从 指定 URL 获 取 原 始 数 据 并 返回 一 个 字 节 流 数组 。getUrLString 
(String) 方 法 则 将 getUrLBytes (String ) 方 法 返回 的 结果 转换 为 String。 

在 FlickrFetchrjava 中 ， 实 现 getUrLBytes(String) 和 getUrLString (String) 方 法 ， 如 代 
码 清单 2$-3 所 示 。 


代码 清单 25-3 ”基本 网 络 连接 代码 (FlickrFetchrjava ) 


public cLass FLickrFetchr { 
public byte[] getUrLBytes(String urlSpec) throws IOException { 
URL urL = new URL(urlSpec); 
HttpURLConnection connection = (HttpURLConnection)url.openConnection(); 














try { 
ByteArrayOutputStream out = new ByteArrayOutputStream(); 
InputStream in = connection.getInputStream(); 


if (connection.getResponseCode() != HttpURLConnection.HTTP_0K) { 
throw new IOException(connection.getResponseMessage() + 
": With " + 
urlSpec); 
} 


int bytesRead = 0; 

byte[] buffer = new byte[1024]; 

while ((bytesRead = in.read(buffer)) > 0) { 
out .write(buffer, 0, bytesRead); 


out.close(); 
return out.toByteArray(); 
} finally { 
connection.disconnect(); 
} 
} 


public String getUrlString(String urlSpec) throws IOEXxception { 
return new String(getUrlBytes (urlSpec)); 
} 
} 


在 getUrlBytes (String) 方 法 中 , 首先 根据 传人 的 字符 串 参 数 ， 如 https:/www.bignerdranch. 
com, 创建 一 个 URL 对 象 ,然后 调用 openConnection() 方 法 创建 一 个 指向 要 访问 URL 的 连接 对 象 。 
URL.openConnection() 方 法 默认 返回 的 是 URLConnection 对 象 ， 但 要 连接 的 是 http URL， 因 此 
需 将 其 强制 类 型 转换 为 HttpURLConnection 对 象 。 这 让 我 们 得 以 调用 它 的 getInputStream()、 
getResponseCode () 等 方法 。 
虽然 HttpURLConnection 对 象 提供 了 一 个 连接 ， 但 只 有 在 调用 getInputStream() 方 法 时 
( 如 果 是 POST 请 求 ， 则 调用 get0utputStream() 方 法 )， 它 才 会 真正 连接 到 指定 的 URL 地 址 ， 才 
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会 给 你 反馈 代码 。 

创建 了 URL 并 打开 网 络 连接 之 后 ， 便 可 循环 调用 read ( ) 方 法 读 取 网 络 数据 ， 直 到 取 完 为 止 。 
只 要 还 有 数据 ，InputStream 类 就 会 不 断 地 输出 字 节 流 数 据 。 数 据 全 部 取 回 后 ， 关 闭 网 络 连接 ， 
Ff 将 他 们 写 人 ByteArray0utputStream 字 节 数 组 中 。 
虽然 最 重要 的 数据 获取 任务 要 靠 getUrlBytes (String) 方 法 完成 , 但 getUrLString(String) 
才 是 本 章 真 正 需要 的 方法 。 它 负责 将 getUrLBytes (String) 方 法 获取 的 字 节 数据 转换 为 String。 
看 到 这 里 , 可 能 有 人 会 问 , 为 什么 不 在 一 个 方法 中 完成 全 部 任务 ?当然 可 以 , 但 是 在 下 一 章 处 理 
图 像 数 据 下 载 时 ， 你 就 能 体会 两 个 独立 方法 的 好 处 了 。 


获取 网 络 使 用 权限 
要 连接 网 络 , 还 需 完成 一 件 事 : 取得 使 用 网 络 的 权限 。 正 如 用 户 怕 被 偷拍 一 样 ， 他 们 也 不 想 


用 偷偷 下 载 图 片 。 
要 取得 网 络 使 用 权限 ， 先 要 在 AndroidManifest.xml 文 件 中 添加 它 ， 如 代码 清单 25-4 所 示 。 


代码 清单 25-4 ”在 配置 文件 中 添加 网 络 使 用 权限 ( AndroidManifest.xml ) 


<manifest 
xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.bignerdranch.android.photogallery" > 








er 


















































于 








<uses-permission android:name="android.permission.INTERNET" /> 
<application 
a ict 
</manifest> 
用 户 下 载 应 用 时 〈 比如 PhotoGallery )， 会 看 到 一 个 注 明 需要 网 络 连接 权限 的 对 话 框 ， 用 户 可 
以 选择 接受 或 拒绝 安装 。 
如 今 ， 大 部 分 应 用 都 需要 联网 ， 所 以 ，Android 视 INTERNET 权 限 为 非 危险 性 权限 。 这 样 一 
来 ， 你 只 要 在 manifest 文 件 里 做 个 声明 ， 就 可 以 直接 使 用 它 了 。 而 有 些 危险 性 权限 ( 如 获取 设备 
地 理 位 置信 息 权限 )， 既 需要 声明 又 需要 运行 时 动态 申请 〈 详 见 第 33 章 )。 


25.3 ”使 用 AsyncTask 在 后 台 线 程 上 运行 代码 


接 下 来 我 们 来 调用 并 测试 新 添加 的 网 络 连 接 代 码 。 注 意 ， 不 要 直接 在 PhotoGaLLery- 
Fragment 类 中 调用 FLickrFetchr.getURLString(String) 方 法 。 正 确 的 做 法 是 ， 创 建 一 个 后 
台 线 程 ， 然 后 在 该 线程 中 运行 代码 。 

使 用 后 台 线 程 最 简便 的 方式 是 使 用 AsyncTask 工 具 类 。AsyncTask 创 建 后 台 线 程 后 ， 我 们 便 
可 在 该 线程 上 调用 doInBackground ( ,., . ) 方 法 运行 代码 。 
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在 PhotoGalleryFragment.java 中 , 添加 一 个 名 为 FetchItemsTask 的 内 部 类 。 覆 盖 AsyncTask . 
doInBackground(...) 方 法 ， 从 目标 网 站 获取 数据 并 记录 日 志 ， 如 代码 清单 25-5 所 示 。 


代码 清单 25-5 ”实现 AsyncTask 工 具 类 方法 ， 第 一 部 分 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
private static final String TAG = "PhotoGalleryFragment"; 
private RecyclerView mPhotoRecyclerView; 


private class FetchItemsTask extends AsyncTask<Void,Void,Void> { 
@Override 
protected Void doInBackground(Void... params) { 
try { 
String result = new FLickrFetchr() 
.getUrlString("https://www.bignerdranch.com"); 
Log.i(TAG, "Fetched contents of URL: " + result); 
} catch (IOException ioe) { 
Log.e(TAG, "Failed to fetch URL: ", ioe); 


return null; 


} 


然后 , 在 PhotoGalleryFragment.onCreate(...) 方 法 中 , 调用 FetchItemsTask 新 实例 的 
execute() 方 法 ， 如 代码 清单 25-6 所 示 。 








代码 清单 25-6 ”实现 AsyncTask 工 具 类 方法 ， 第 二 部 分 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
private static final String TAG = "PhotoGalleryFragment"; 
private RecyclerView mPhotoRecyclerView; 


@Override 

public void onCreate(Bundle savedInstance9tate) { 
super.onCreate(savedInstanceState); 
setRetainInstance(true); 
new FetchItemsTask().execute(); 


} 

调用 execute() 方 法 会 启动 AsyncTask， 进 而 触发 后 台 线 程 并 调用 doInBackground(...) 
方法 。 运 行 PhotoGallery 应 用 ， 查 看 LogCat 窗 口 ， 可 以 看 到 一 大 堆 Big Nerd Ranch 网 站 主页 HTML 
代码 ， 如 图 25-5 所 示 。 

LogCat 徐 口中 的 日 志 可 不 好 找 。 要 养 成 使 用 关键 词 搜索 的 好 习惯 。 图 25-5 就 是 在 LogCat 搜 索 
框 中 输入 PhotoGalleryFragment 后 的 查找 结果 。 
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hi logcat Monitors 六 Verbose 一 Qr PhotoGalleryFragment 四 Regex Show only selected application 固 


合 09-22 13:33:04.363 2448-2476/com.bignerdranch,android,photogallery I/PhotoGalleryFragment: Fetched contents of URL: <!DOCTYPE html> <! 一 [if lt IE 7]> 
<html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]--> <! 一 [if IE 7]> <html class="no~js lt-ie9 lt-ie8"> <![endif]-——> <! 一 [if IE 8]> <html class="no-js 

[| lt-ie9"> <![endif] 一 > <! 一 [if gt IE 8]><! 一 > <html class="no-js"> <! 一 <![endif] 一 > <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" 
content="TE=edge,chrome=1"> <title>Big Nerd Ranch ~ Mobile App Development, Training &amp; Programming Guides | Big Nerd Ranch</title> <meta 


个 name="robots" content="noodp"> <meta name="description" content="Based in Atlanta, GA, Big Nerd Ranch develops custom mobile apps, teaches immersive 

» development bootcamps and writes best-selling programming guides," "> <meta name="viewport" content="width=device-width"> <Link rel=" stylesheet” 
href="/assets/appLication-db92319bc2b8f7323359326e2005340d,css"> <link rel="alternate" type="application/rss+xml" title="RSS" href="/rss.xml"> <Link 

到 | ~rel="shortcut icon" type="image/x-icon" href="/favicon.png"> <tink rel="canonical" href="https://ww, bignerdranch,con/"> <meta property="0g:title" 
‘content="Big Nerd Ranch ~ Mobile App Deve opments Training Samp; Progranming Guides | Big Nerd Ranch"> <meta property="og;site_name”content="Big Nerd 
Ranch"> <meta property="0g:url" content=" "> <meta property="0g:description" content="Based in Atlanta, GA, Big Nerd Ranch 


5 上 


develops custom mobile apps, teaches immersive development bootcamps and writes best-selling programming guides."> <meta property="og; Joe 
content="https://www. bignerdranch. com/ima/bnr-10g0-square. pna"> </head> <body> <noscript><iframe src="// 


图 25-5 ”LogCat 中 的 HTML 代 码 


既然 已 创建 了 后 台 线 程 ， 并 成 功 完 成 了 网 络 连 接 代 码 的 测试 ， 接 下 来 ， 我 们 来 深入 学 习 
Android 线 程 的 知识 。 


25.4 线程 与 主线 程 


网 络 连接 需要 时 间 。Web 服 务 器 可 能 需要 1~2 秒 的 时 间 来 响应 ， 文 件 下 载 则 耗 时 更 入。 考虑 
到 这 个 因素 ，Android 禁 止 任何 主线 程 网 络 连 接 行为 。 即使 强 和 行为 之 ，Android 也 会 抛 出 
NetworkOnMainThreadException 异 常 。 

这 是 为 什么 呢 ? 要 想 知 道 答案 , 首先 要 知道 什么 是 线程 , 什么 是 主线 程 , 主线 程 有 什么 用 途 。 

线程 是 个 单一 执行 序列 。 单 个 线程 中 的 代码 会 逐步 执行 。 所 有 Android 应 用 的 运行 都 是 从 主 
线程 开始 的 。 然 而 ， 主 线程 不 是 线程 那样 的 预定 执行 序列 。 相 反 ， 它 处 于 一 个 无 限 循 环 的 运行 状 
态 ， 等 着 用 户 或 系统 触发 事件 。 一 旦 有 事件 触发 ， 主 线程 便 执 行 代码 做 出 响应 





















































一 般 线程 主线 程 
(来 自 于 Android 或 用 户 ) 














/ 
触发 事件 














、\ 
We 


























图 25-6 ”一般 线程 与 主线 程 


把 应 用 想象 成 一 家 大 型 鞋 店 , 闪电 侠 是 这 家 店 唯一 的 员工 。( 是 不 是 人 人 梦 容 以 求 的 场景 ? ) 
要 让 客户 满意 ,他 需要 做 大 量 的 工作 ， 如 布置 商品 、 为 顾客 取 鞋 、 为 顾客 量 尺寸 a 闪电 侠 并 非 
浪 得 虚名 ， 所 以 ， 即 便 所 有 工作 都 由 他 一 人 完成 ， 客 户 也 能 得 到 及 时 响应 ， 感 到 满意 。 

为 及 时 完成 任务 , 闪电 侠 不 能 在 单一 事件 上 耗 时 过 久 。 要 是 一 批 货 到 了 怎么 办 ? 这 时 ,必须 
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有 人 花 时 间 打 电话 调查 此 事 。 假 设 让 闪电 侠 去 做 , 他 在 忙于 联络 查找 货物 时 ， 店 里 等 候 的 顾客 可 
就 不 耐烦 了 。 
闪电 侠 就 像 应 用 里 的 主线 程 。 它 运行 着 所 有 更 新 UI 的 代码 ， 其 中 包括 响应 activity 的 启动 、 按 
钮 的 点 击 等 不 同 UI 相 关 事 件 的 代码 。( 由 于 响应 的 事件 基本 都 与 用 户 界 面相 关 ， 主 线程 有 时 也 叫 
作 UI 线 程 。) 
事件 处 理 循环 让 UI 代码 总 是 按 顺 序 执行 。 这 样 ， 事 件 就 能 一 件 件 处 理 ， 不 用 担心 互相 冲突 ， 
同时 代码 也 能 够 快速 执行 ， 及 时 响应 。 目 前 为 止 , 我 们 编写 的 所 有 代码 (刚刚 使 用 AsyncTask 工 
具 类 完成 的 代码 除外 ) 都 是 在 主线 程 中 执行 的 。 


连接 网 络 如 同 致电 分 销 商 找 竺 失 的 货物 : 相 比 其 他 任务 ， 它 更 耗 时 。 等 待 响 应 期 间 ， 用 户 界 
面 毫 无 反应 ， 这 可 能 会 导致 应 用 无 响应 (application not responding，ANR ) 现象 发 生 。 


如 果 Android 系 统 监 控 服 务 确认 主线 程 无 法 响应 重要 事件 ， 如 按 下 后 退 键 等 ， 则 应 用 无 响应 
会 发 生 。 用 户 就 会 看 到 如 图 25-7 所 示 的 画面 。 





























PhotoGallery isn't responding 


x Close app 


© wait 








图 25-7 ”应 用 无 响应 


回 到 假想 的 鞋 店 中 ， 要 解决 问题 ， 自 然 想 到 再 雇 一 名 闪电 侠 专 门 负 责 联络 供销 商 。Android 
系统 中 的 做 法 与 之 类 似 ， 即 创建 一 个 后 台 线程 ， 然 后 从 该 线程 访问 网 络 。 

怎样 使 用 后 台 线 程 最 容易 ? 使 用 AsyncTask 工 具 类 。 

稍 后 ， 还 会 看 到 AsyncTask 类 的 其 他 用 处 。 现 在 ， 还 是 先 利 用 网 络 连接 代码 做 点 实事 吧 。 
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25.5 从 Flickr 获取 JSON 数据 


JSON (JavaScript Object Notation ) 是 近年 流行 开 来 的 一 种 数据 格式 ， 尤 其 适用 于 Web 服 务 。 
Android 提 供 了 标准 的 org.json 包 ， 可 以 利用 包 里 的 一 些 类 创建 和 解析 JSON 数 据 。Android 开 发 者 
文档 有 其 详细 信息 。 要 详细 了 人 解 JSON 数 据 格 式 ， 请 访问 json.org 网 站 。 

Flickr 提 供 了 方便 而 强大 的 JSON API。 可 从 www.flickr.com/services/api/ 文 档 页 查看 使 用 细节 。 
在 常用 浏览 器 中 打开 API 文 档 网 页 , 找到 Request Formats 列 表 。 我 们 打算 使 用 最 简单 的 REST 服 务 。 
查 文档 得 知 , 它 的 API 端 点 (endpoint ) 是 https://api.flickr.com/services/rest/。 可 在 此 端点 上 调用 Flickr 
提供 的 方法 。 

回 到 API 文 档 主 页 ， 找 到 API Methods 列 表 。 向 下 深 动 到 photos 区 域 并 找到 flickr.photos. 
getRecent 方 法 。 点 击 查看 该 方法 。 文 档 对 该 方法 的 描述 为 :“ 返 回 最 近 上 传 到 flickr 的 公共 图 片 
清单 。” 这 恰好 就 是 PhotoGallery 应 用 需要 的 方法 。 

getRecent 方 法 需要 的 唯一 参数 是 一 个 APIkey。 为 获得 它 ， 回 到 www.flickrcomy services/api/ 
网 页 ， 找 到 并 点 击 APIkeys 链 接 进 行 申请 。 申 请 需 使 用 Yahoo ID 登录 。 你 可 以 登录 并 申请 一 个 非 商 
业 用 途 API key。 申 请 成 功 后 ， 可 获得 类 似 4f721bgafa75bf6d2cb9af54f937bb70 这 样 的 API key。( 申 
请 API key 时 , 还 会 得 到 一 个 用 来 访问 特定 用 户 信息 和 图 片 的 Secret key。 这 里 不 需要 , 忽略 即 可 。 ) 

得 到 APIkey 后 ， 可 直接 向 Flickr 网 络 服务 发 起 一 个 和 下 面 类 似 的 GET 请 求 : 


https://api.flickr.com/services/rest/? 
method=flickr.photos.getRecent&api key=xxx&format=json&nojsoncallback=1 


Flickr 默 认 返 回 XML 格 式 的 数据 。 要 获得 有 效 的 JSON 数 据 ， 就 需要 同时 指定 format 和 
nojsoncallback 参 数 , 设置 nojsoncallback 为 1 就 是 告诉 Flickr, 返回 的 数据 不 应 包括 封闭 方法 
名 和 括号 。 这 样 才 会 方便 解析 数据 。 

复制 上 述 链接 到 浏览 器 , 使 用 刚 获取 的 API key 蔡 换 xxx 字 符 后 回 车 。 很 快 , 就 能 看 到 如 图 25-8 
所 示 的 JSON 返 回 数据 。 
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“photos": {"pag 





:0, 
NOS5" 

nd" :0,"isfamily 
:1"444943728N05", "gS 


图 25-8 ” ”JSON 数据 示例 
接 下 来 开始 编码 。 首 先 ， 在 FlickrFetchr 类 中 添加 一 些 常 量 ， 如 代码 清单 25-7 所 示 。 


代码 清单 25-7 添加 一 些 常量 (FlickrFetchrjava ) 
public class FlickrFetchr { 





itle":"NASA Robot Brain 














{ 
[ 
We 
‘ 
. 
{ 
R 
‘ 
R 
{ 
? 
{ 
8 
{ 
R 
‘ 
S 
{ 


urgeon" , "ispublic 和 
"id":"8981696202", t":"1447feblaf", "server":"7441","farm":8,"title":"Mars Science 





private static final String TAG = "FlickrFetchr"; 
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private static final String API_KEY = "youwrApiKeyHere"; 


} 
记得 把 yourApiKeyHere 替 换 成 刚 获取 的 API key。 
使 用 刚才 定义 的 常量 编写 一 个 方法 ,构建 请 求 URL 并 获取 内 容 ， 如 代码 清单 25-8 所 示 。 


代码 清单 25-8 ”添加 fetchItems() 方 法 (FlickrFetchrjava ) 
public class FlickrFetchr { 























public String getUrlString(String urlSpec) throws IOEXxception { 
return new String(getUrlBytes(urlSpec)); 


} 
public void fetchItems() { 
try { 
String url = Uri.parse("https://api.flickr.com/services/rest/") 


.buiLdUpon() 
.appendQueryParameter("method", "flickr.photos.getRecent") 
.appendQueryParameter("api key", API KEY) 
.appendQueryParameter("format", "json") 
.appendQueryParameter("nojsoncallback", "1") 
.appendQueryParameter("extras", "url s") 
.build().toString(); 

String jsonString = getUrlString(url); 

Log.i(TAG, "Received JSON: " + jsonString); 

} catch (IOException ioe) { 
Log.e(TAG, "Failed to fetch items", ioe); 


} 





这 里 , 我 们 使 用 Uri.Builder 构 建 了 完整 的 Flickr API 请 求 URL。 便利 类 Uri.Builder 可 创建 
正确 转 义 的 参数 化 URL。Uri.Builder.appendQueryParameter(String,String) 可 自动 转 义 





查询 字符 串 。 











注意 ,我 们 还 添加 了 method、api key、format 和 nojsoncallback 参 数值 。 另外 还 指定 了 


一 个 值 为 urL_s 的 ext ras 参 数 。 这 个 参数 值 告诉 Flickr: 如 有 小 尺寸 图 片 ， 也 一 并 返回 其 URL。 
最 后 ， 修 改 PhotoGalleryFragment 类 中 的 AsyncTask 内 部 类 ， 调 用 新 的 fetchItems() 方 








法 ， 如 代码 清单 25-9 所 示 。 


代码 清单 25-9 ”调用 fetchItems() 方 法 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 





private class FetchItemsTask extends AsyncTask<Void,Void,Void> { 
@Override 
protected Void doInBackground(Void... params) { 





String result = new FlickrFetchr() 


Log.i(TAG, "Fetched contents of URL: ”+ result); 
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Leg-e(TAG, "Failed to fetch_URL: “ee) 二 





} 
new FlickrFetchr().fetchItems(); 
return null; 


} 
运行 PhotoGallery 应 用 。 可 看 到 LogCat 窗 口中 的 Flickr JSON 数 据 ， 如 图 25-9 所 示 。( 在 LogCat 
搜索 框 中 输入 FlickrFetchr 可 以 方便 查找 。) 


ilogcat Monitors +” Verbose “加 QFlickrFetchr 四 回 Regex Show only selected application 回 








合 09-22 15:17:62.472 14059-14978/com.bignerdranch.android.photogallery I/FlickrFetchr: Received JSON: {"photos":{"page":1,"pages":10,"perpage":100,"total":100 


画 


+ 


时 





图 25-9 ”Flickr JSON 数 据 25 


本 书 撰写 时 ，Android Studio 的 LogCat 窗 口 还 无 法 换行 显示 。 想 查看 JSON 字 符 串 完整 内 容 ， 
需 向 右 滚动 窗口 。( LogCat 有 时 不 好 伺候 。 假 如 看 不 到 类 似 图 25-9 的 结果 ， 也 不 用 担心 。 模 拟 器 
连接 有 时 不 够 稳定 ， 可 能 无 法 及 时 显示 日 志 内 容 。 通 常 ， 它 能 自己 恢复 。 实 在 不 行 ， 请 重启 应 用 
或 重启 模拟 器 。) 

成 功 取得 FlickrJSON 返 回 结果 后 , 该 如 何 使 用 呢 ? 和 处 理 其 他 数据 一 样 , 将 其 存 人 一 个 或 多 
个 模型 对 象 中 。 稍 后 会 为 PhotoGallery 应 用 创建 的 模型 类 名 为 GalleryItem。 图 25-10 为 
PhotoGallery 应 用 的 对 象 图 解 。 

模型 
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视图 (布局 ) 





图 25-10 PhotoGallery 应 用 的 对 象 图 解 
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意 ， 为 聚焦 fragment 和 网 络 连接 代码 ， 图 25-10 并 没有 显示 托管 activity。 
Sn 关 代 码 ， 如 代码 清单 25-10 所 示 。 


代码 清单 25-10 ”创建 模型 对 象 类 ( Galleryltem.java ) 


public class GalleryItem { 
private String mCaption; 
private String mId; 
private String mUrl; 





@Override 
public String toString() { 
return mCaption; 
} 
} 


利用 Android Studio 自 动 为 nCaption、mId 和 mUrl 变 量 生成 getter 与 setter 方 法 。 
完成 模型 层 对 象 的 创建 后 ， 接 下 来 的 任务 就 是 塞 人 JSON 解 析 数 据 。 


解析 JSON 数据 


浏览 器 和 LogCat 中 显示 的 JSON 数 据 难以 阅读 。 如 果 用 空格 回 车 符 格式 化 后 再 打印 出 来 ， 结 
果 大 致 如 图 25-11 所 示 。 


{ 
"photos": { JSONObject 
"page": 1, 


pages": 10, getJSONObject(“photos’”) 














"perpage": 100, 
"total": 1000， 
"photo": [ 
{ 
"owner": "44494372GN05"， 
"secret": "d6d20af93e", getJSONArray(“photo”) 
"server": "7365", 
"farm": 8, y 
"title": "Low and Wisoff at Work", 
ispublic": 1, | JSoNAray | 
"isfriend": 0， 
}, A getJSONObject(index) 
{ 
"id": "16317817559", 4 
"owner": "44494372GN05"， se 
"secret": "137d97804f"， | jsonobjeot | 
server": "8683", 
"farm": 9, 
"title": "Challenger as seen from SPAS", 
"ispublic":; 1, 
"isfriend": 0， 
"isfamily": 0 
] 
}, 
ustat": "ok" 





图 25-11 格式 化 后 的 JSON 数 据 
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JSON 对 象 是 一 系列 包含 在 { } 中 的 名 值 对 。JSON 数 组 是 包含 在 [ ] 中 用 逗号 隔 开 的 JSON 对 
象 列表 。 对 象 彼此 骨 套 形成 层级 关系 。 

json.org API 提 供 有 对 应 JSON 数 据 的 Java 对 象 ， 如 JSONObject 和 JSONArray。 使 用 
JSONObject(String) 构 造 函 数 ， 可 以 很 方便 地 把 JSON 数 据 解析 进 相 应 的 Java 对 象 。 更 新 
fetchItems() 方 法 执行 解析 任务 ， 如 代码 清单 25-11 所 示 。 


代码 清单 25-11 解析 JSON 数 据 (FlickrFetchrjava ) 
public cLass FLickrFetchr { 











private static final String TAG = "FlickrFetchr"; 


public void fetchItems() { 
try { 


Log.i(TAG, "Received JSON: " + jsonString); 
JSONObject jsonBody = new JSONObject(jsonString); 
} catch (IOException ioe) { 
Log.e(TAG, "Failed to fetch items", ioe); 
} catch (JSONException je){ 
Log.e(TAG, "Failed to parse JSON", je); 





} 

} 

JSON0bject 构 造 方 法 解析 传 入 的 Flickr JSON 数 据 后 ,会 生成 与 原始 JSON 数 据 对 应 的 对 象 树 ， 
如 图 25-11 所 示 。 

比较 对 象 树 和 原始 数据 可 知 ， 顶 层 JSON0bject 对 应 着 原始 数据 最 外 层 的 { }。 它 包含 了 一 个 
叫 作 photos 的 租 套 JSON0bject。 层 层 往 下 ， 这 个 向 套 对 象 又 包含 了 一 个 叫 作 photo 的 JSONArray。 
这 个 般 套 数组 中 又 包含 了 一 组 JSON0bject， 而 数组 中 的 一 个 个 JSON0bject 就 是 要 获取 的 图 片 
metadata 数 据 。 

写 一 个 parseItems(...) 方 法 , 取出 每 张 图 片 的 信息 ,生成 一 个 个 6alleryItem 对 象 , 再 将 
它们 添加 到 List 中 ， 如 代码 清单 25-12 所 示 。 


代码 清单 25-12 ”解析 Flickr 图 片 (FlickrFetchr.java ) 
public class FlickrFetchr { 











private static final String TAG = "FlickrFetchr",; 
public void fetchItems() { 


} 


private void parseItems(List<GaLLeryItem> items, JSONObject jsonBody) 
throws IOException, JSONException { 


JSONObject photosJsonObject = jsonBody.getJSONObject("photos"); 
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JSONArray photoJsonArray = photosJson0bject.getJSONArray("photo") ; 


for (int i = 0; i < photoJsonArray.length(); i++) { 
JSONObject photoJsonObject = photoJsonArray.getJSONObject(i); 


GalleryItem item = new GalleryItem(); 
item.setId(photoJsonObject.getString("id")); 
item.setCaption(photoJsonObject.getString("title")); 


if (!photoJsonObject.has("url s")) { 
continue; 


} 


item.setUrl(photoJsonObject.getString("url s")); 
items.add(item); 


} 


解析 ]SON0bject 层 级 结构 时 , 上述 代 码 用 了 getJSONObject (String name) 和 getJSONArray 


(String name) 这 两 个 便利 方法 (已 标注 在 图 25-11 中 )。 
并 不 是 每 张 图 片 都 有 对 应 的 url_s 链 接 ， 所 以 需要 添加 一 个 检查 。 





parseItems(...) 方 法 需要 List 和 JSON0bject 参 数 。 因 此 ， 还 要 更 新 fetchItems() 方 法 ， 


让 它 返 回 一 个 包含 6alleryItem 的 List， 如 代码 清单 25-13 所 示 。 


代码 清单 25-13 ”调用 parseItems (...) 方 法 (FlickrFetchr.java ) 
public void List<GaLLeryItem> fetchItems() { 


List<GalleryItem> items = new ArrayList<>(); 


try { 
String url = ...; 
String jsonString = getUrlString(url); 
Log.i(TAG, "Received JSON: " + jsonString); 
JSONObject jsonBody = new JSONObject(jsonString); 
parseItems (items，jsonBody) ; 

} catch (JSONException je) { 

Log.e(TAG, "Failed to parse JSON", je); 

} catch (IOException ioe) { 
Log.e(TAG, "Failed to fetch items", ioe); 

} 


return items; 


} 


运行 PhotoGallery 应 用 ， 测 试 JSON 解 析 代 码 。 现 在 ，PhotoGallery 应 用 还 无 法 展示 List 中 的 











内 容 。 因 此 ， 要 确认 代码 是 否 正确 ， 需 设置 合适 的 断 点 ， 使 用 调试 器 来 检查 代码 逻辑 。 
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25.6 从 AsyncTask 回 到 主线 程 


为 完成 本 章 的 既定 目标 ， 我 们 回 到 视图 层 部 分 ， 实 现在 PhotoGaLLeryFragment 类 的 
RecyclerView 中 显示 图 片 标题 。 
首先 定义 一 个 ViewHolder 内 部 类 ， 如 代码 清单 25-14 所 示 。 


代码 清单 25-14 ”添加 ViewHolder 实 现 ( PhotoGalleryFragment.java ) 


@Override 
public View onCreateView(layoutinflater inflater, ViewGroup container, 
Bundle savedinstanceState) { 


} 


private class PhotoHolder extends RecyclerView.ViewHolder { 
private TextView mTitleTextView; 


public PhotoHolder (View itemView) { 
super (itemView); 





mTitleTextView = (TextView) itemView; 


} 


public void bindGalleryItem(GalleryItem item) { 
mTitleTextView.setText(item.toString()); 
} 
} 


private class FetchItemsTask extends AsyncTask<Void,Void,Void> { 


} 
} 


接 下 来 ， 添 加 一 个 RecyclerView.Adapter 实 现 ， 提供 基于 GalleryItem 对 象 List 的 
PhotoHolder， 如 代码 清单 25-15 所 示 。 


代码 清单 25-15 ”添加 RecyclerView.Adapter 实 现 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
private static final String TAG = "PhotoGalleryFragment"; 
DPT class PhotoHolder extends RecyclerView.ViewHolder { 
} 
private class PhotoAdapter extends RecyclerView.Adapter<PhotoHolder> { 
private List<GalleryItem> mGalleryItems; 
public PhotoAdapter(List<GalleryItem> galleryItems) { 


mGalleryItems = galleryItems; 
} 
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@Override 

public PhotoHolder onCreateViewHolder (ViewGroup viewGroup, int viewType) { 
TextView textView = new TextView(getActivity()); 
return new PhotoHolder (textView); 


} 


@Override 

public void onBindViewHolder (PhotoHolder photoHolder, int position) { 
GalleryItem galleryItem = mGalleryItems.get(position); 
photoHolder .bindGalleryItem(galleryItem); 

} 


@Override 
public int getItemCount() { 
return mGalleryItems.size(); 


} 


} 


既然 RecycLerView 要 显示 的 数据 已 准备 就 绪 ， 那 么 接 下 来 编码 完成 adapter 的 配置 和 关联 ， 
如 代码 清单 25-16 所 示 。 








代码 清单 25-16 ”实现 setupAdapter() 方 法 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
private static final String TAG = "PhotoGalleryFragment"; 


private RecyclerView mPhotoRecyclerView; 

private List<GalleryItem> mItems = new ArrayList<>(); 

@Override 

public View onCreateView(LayoutInflater inflater, ViewGroup container, 


Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment photo gallery, container, false); 


mPhotoRecyclerView = (RecyclerView) v.findViewById(R.id.photo recycler view); 
mPhotoRecyclerView,.setLayoutManager (new GridLayoutManager(getActivity(), 3)); 


setupAdapter(); 


return v; 


} 


private void setupAdapter() { 
if (isAdded()) { 
mPhotoRecyclerView.setAdapter (new PhotoAdapter (mItems)); 
} 
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根据 当前 模型 数据 ( GalleryItem 对 象 List ) 的 状态 ， 刚 才 添 加 的 setupAdapter() 方 法 会 
自动 配置 RecyclerView 的 adapter。 应 在 onCreateView(...) 方 法 中 调用 该 方法 ， 这 样 每 次 因 设 
备 旋转 重新 生成 RecycLerView 时 ， 可 重新 为 其 k 配 置 对 应 的 adapter。 另外 ， 每 次 模型 层 对 象 发 生 
变化 时 ， 也 应 及 时 调用 该 方法 。 

注意 ， 配 置 adapter 前 ， 应 检查 jsAdded( ) 的 返回 值 是 否 为 true。 该 检查 确认 fragment 已 与 目 
标 activity 相 关联 ， 从 而 保证 getActivity() 方 法 返回 结果 非 空 

还 记得 吗 ? fragment 可 脱离 任何 activity 而 独立 存在 。 在 这 之 前 ， 所 有 的 方法 调用 都 是 由 系统 框架 
的 回调 方法 驱动 的 ， 所 以 不 会 出 现 这 种 情况 。 本 例 中 ， 如 果 fragment 在 接收 回调 指令 ， 则 它 必 然 关联 
着 某 个 activity; 如 它 单独 存在 ， 也 就 不 会 收 到 回调 。 

既然 在 用 AsyncTask， 说 明正 在 从 后 台 进 程 触发 回调 指令 。 因 而 不 能 确定 fragment 是 否 关联 
着 activity。 那 就 必须 确认 fragment 是 和 否 仍 与 activity 关 联 。 如 果 没 有 关联 , 依赖 于 activity 的 操作 ( 如 
创建 PhotoAdapter， 进 而 还 会 使 用 托管 activity 作 为 context 来 创建 TextView ) 就 会 失败 。 所 以 , 设 
置 adapter 之 前 ， 你 需要 确认 isAdded ( ) 方 法 返回 值 。 

现在 ， 从 Flickr 成 功 获取 数据 后 ， 就 需要 调用 setupAdapter() 方 法 。 你 的 第 一 反应 可 能 是 在 
FetchItemsTask 的 doInBackground(...) 方 法 尾部 调用 它 。 这 不 是 个 好 主意 。 还 记得 闪电 侠 与 
鞋 店 吗 ?现在 ， 店 里 有 两 个 内 电 侠 ， 一 个 忙于 应 付 顾客 ， 一 个 忙于 与 Flickr 电 话 沟通 。 如 果 第 二 
个 闪电 侠 结 束 通话 后 , 过 来 帮忙 招呼 顾客 ， ee 结局 很 可 能 是 两 位 内 电 侠 无 法 协 
调 一 致 ， 产 生 冲 突 。 

在 计算 机 里 ， 内 存 对 象 相 互 踩踏 会 让 应 用 朋 演 。 因 此 ,安全 起 见 , 不 推荐 也 不 允许 从 后 台 线 
程 更 新 UI。 

那么 应 该 怎么 做 呢 ? 不 用 担心 ,AsyncTask 还 有 另 一 个 可 覆盖 的 onPostExecute(..,) 方 法 。 
onPostExecute(.,,) 方 法 在 doInBackground(..,) 方 法 执行 完毕 后 才 会 运行 。 更 为 重要 的 是 ， 
它 是 在 主线 程 而 非 后 台 线程 上 运行 的 。 因 此 ， 在 该 方法 中 更 新 UI 比较 安全 。 

修改 FetchItemsTask 类 以 新 的 方式 更 新 mItems, 并 在 成 功 获 取 图 片 后 调用 setupAdapter() 
方法 更 新 RecyclerView 的 数据 源 ， 如 代码 清单 25-17 所 示 。 


代码 清单 25-17 添加 adapter 更 新 代码 ( PhotoGalleryFragment.java ) 


private class FetchItemsTask extends AsyncTask<Void,Void,Veid List<GalleryItem>> { 
@Override 
protected Veid List<GalleryItem> doInBackground(Void... params) { 
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return new FlickrFetchr().fetchItems(); 
return nutlt; 
} 


@Override 

protected void onPostExecute(List<GalleryItem> items) { 
mItems = items; 
setupAdapter(); 

} 
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上 述 代码 有 三 处 调整 。 首 先 ， 我们 改变 了 FetchItemsTask 类 第 三 个 泛 型 参数 的 类 型 。 该 参 
数 是 AsyncTask 返 回 结果 的 数据 类 型 。 也 就 是 doInBackground(,..) 方 法 返回 结果 的 数据 类 型 ， 
以 及 onPostExecute(...) 方 法 输入 参数 的 数据 类 型 。 

其 次 ,我 们 让 doInBackground(...) 方 法 返回 了 GalleryItem 对 象 List。 这 样 既 修正 了 代 
码 编译 错误 ， 还 将 GalleryItem 对 象 List 传 递 给 了 onPostExecute(...) 方 法 。 

最 后 ， 我 们 添加 了 onPostExecute(...) 方 法 实现 代码 。 该 方法 接收 doInBackground(...) 方 
法 返回 的 GalleryItem 数 据 ， 并 放 人 和信 mItems 变量 ,然后 调用 setupAdapter() 方 法 更 新 
RecyclerView 视 图 的 adapter。 

至 此 ， 本 章 任 务 就 完成 了 。 运 行 PhotoGallery 应 用 ， 可 看 到 屏幕 上 显示 出 全 部 已 下 载 
GalleryItem 的 标题 ( 类 似 图 25-2 )。 
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25.7 清理 AsyncTask 


本 章 ，AsyncTask 运 用 得 还 算得 当 ， 因 此 不 用 去 管理 AsyncTask 实 例 了 。 例 如 ， 我 们 保留 了 
fragment ( 调用 setRetainInstance(true) 方 法 )， 这 样 即 使 设备 旋转 ， 也 不 会 重复 创建 新 的 
AsyncTask 去 获取 JSON 数 据 。 然 而 ， 有 些 情况 下 ， 必 须 好 好 掌控 它 ， 必 要 时 ， 甚 至 要 能 撤销 或 重 
新 运行 AsyncTask。 

针对 某 些 复杂 应 用 场景 ， 我 们 需要 将 AsyncTask 赋 值 给 实例 变量 。 这 样 ， 一 旦 掌控 了 它 ， 就 
能 随时 调用 AsyncTask.cancel (boolean) 方 法 ， 撤 销 运行 中 的 AsyncTask。 

AsyncTask.cancel (boolean) 方 法 有 两 种 工作 模式 : 粗暴 的 和 温和 的 。 如 果 调 用 cancel 
(false) 方 法 ， 它 只 是 简单 地 设置 isCancelled() 的 状态 为 true。 随 后 ，AsyncTask 会 检查 
isCanceLLed() 状 态 ， 然 后 选择 提前 结束 运行 。 

然而 ， 如 果 调 用 canceL(true ) 方 法 ， 它 会 立即 终止 doInBackground (...) 方 法 当前 所 在 的 
线程 。 AsyncTask.cancel (true) 方 法 停止 AsyncTask 的 方式 简单 粗暴 ,如 果 可 能 , 应 尽量 避免 。 

应 该 在 什么 时 候 、 什 么 地 方 撤销 AsyncTask 呢 ?这 要 看 情况 了 。 先 问 问 自己 ， 如 果 fragment 
或 activity 已 销毁 了 或 是 看 不 到 了 ，AsyncTask 当 前 的 工作 可 以 停止 吗 ? 如 果 可 以 ， 就 在 
onStop(...) 方 法 里 (看 不 到 视图 ), 或 者 在 onDestroy(...) 方 法 里 (fragment/activity 实 例 已 销 
毁 ) 撤销 AsyncTask 实 例 。 

即使 ffragment/activity 已 销毁 了 (或 者 视图 已 看 不 到 了 )， 也 可 以 不 撤销 AsyncTask， 让 它 运 
行 至 结束 把 事情 做 完 。 不 过 ， 这 可 能 会 引发 内 存 泄漏 (比如 ， 没 用 的 Activity 实 例 本 应 销毁 ， 但 
一 直 还 在 内 存 里 ), 也 可 能 会 出 现 UI 更 新 问题 ( 因为 UI 已 失效 )。 如 果 不 管用 户 怎么 操作 ， 要 确保 
重要 工作 能 完成 ， 那 最 好 考虑 其 他 解决 方案 ， 比 如 使 用 service ( 详 见 第 28 章 )。 


25.8 深入 学 习 : AsyncTask 再 探 


你 已 知道 如 何 使 用 AsyncTask 的 第 三 个 类 型 参数 ， 那 另外 两 个 类 型 参数 呢 ? 
第 一 个 类 型 参数 可 指定 将 要 转 给 execute(...) 方 法 的 输入 参数 的 类 型 ， 进 而 确定 
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doInBackground(...) 方 法 输入 参数 的 类 型 。 具 体 用 法 可 参考 以 下 示例 : 


AsyncTask<String,Void,Void> task = new AsyncTask<String,Void,Void>() { 
public Void doInBackground(String... params) { 
for (String parameter : params) { 





Log.i(TAG, "Received parameter: " + parameter); 
} 
return null; 
} 
}; 
输入 参数 传人 execute(.,. ) 方 法 (可 接受 一 个 或 多 个 参数 ): 
task.execute("First parameter", "Second parameter", "Etc."); 


然后 ， 再 把 这 些 变 量 参数 传递 给 doInBackground(... ) 方 法 。 
第 二 个 类 型 参数 可 指定 发 送 进 度 更 新 需要 的 类 型 。 以 下 为 示例 代码 : 


final ProgressBar gestationProgressBar = /* A determinate progress bar */; 
gestationProgressBar.setMax(42); /* max allowed gestation period */ 








AsyncTask<Void, Integer,Void> haveABaby = new AsyncTask<Void,Integer,Void>() { 
public Void doInBackground(Void... params) { 
while (!babyIsBorn()) { 
Integer weeksPassed = getNumber0fWeeksPassed ( ) ; 
publishProgress (weeksPassed); 
patientlywaitForBaby(); 


} 


public void onProgressUpdate(Integer... params) { 
int progress = params[0]; 
gestationProgressBar.setProgress(progress); 


}; 


/* call when you want to execute the AsyncTask */ 
haveABaby .execute(); 


进度 更 新 通常 发 生 在 后 台 进 程 执行 中 途 。 问 题 是 , 在 后 人 台 进 程 中 无 法 完成 必要 的 UI 更 新 。 因 
此 AsyncTask 提 供 了 publishProgress(...) 和 onProgressUpdate(...) 方 法 。 

其 工作 方式 是 这 样 的 : 在 后 台 线程 中 ， nt ) 方法 中 调用 
人 ress(...) 方 法 。 这 样 onProgressUpdate(... ) 方 法 便 和 g 饮 在 UI 线程 上 调用 ， 因 

， 在 onProg ee . ) 方 法 中 执行 UI 更 新 就 可 行 但 必须 在 doInBackground(...) 
2 ress(...) 方 法 对 它们 进行 管控 。 




















25.9 深入 学 习 : AsyncTask 的 替代 方案 
在 使 用 AsyncTask 加 载 数据 时 ， 如 果 遇 到 设备 配置 变化 ， 比 如 设备 旋转 ， 你 得 负责 管理 它 的 
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生命 周期 , 同时 还 要 保存 好 数据 , 不 让 其 因 旋转 丢失 。 虽 然 调 用 Fragment 的 setRetainInstance 
(true) 方 法 来 保存 数据 可 以 解决 问题 ， 但 它 不 是 万 能 的 。 很 多 时 候 ， 你 还 得 介入 ， 编 写 特殊 场 
景 应 对 代码 ， 让 应 用 无 懈 可 击 。 这 些 特殊 场景 有 : 用 户 在 AsyncTask 运 行 时 按 后 退 键 ， 以 及 启动 
AsyncTask 的 fragment 因 内 存 紧张 而 被 销毁 。 

使 用 Loader 是 另 一 种 可 行 的 解决 方案 。 它 可 以 代劳 很 多 ( 并 非 全 部 ) 环 手 的 事情 。Loader 
用 来 从 某 些 数据 源 加 载 数据 ( 对 象 )。 数 据 源 可 以 是 磁盘 、 数 据 库 、ContentProvider、 网 络 ， 
甚至 是 另 一 进程 。 

AsyncTaskLoader 是 个 抽象 Loader。 它 可 以 使 用 AsyncTask 把 数据 加 载 工作 转移 到 其 他 线程 
上 。 我 们 创建 的 loader 类 几乎 都 是 AsyncTaskLoader 的 子 类 。AsyncTaskLoader 能 在 不 阻塞 主线 
程 的 前 提 下 获取 到 数据 ， 并 把 结果 发 送 给 目标 对 象 。 

相 比 AsyncTask， 为 什么 要 推荐 使 用 loader 呢 ? 最 重要 的 原因 是 ， 遇 到 类 似 设备 旋转 这 样 的 
场景 时 ，LoaderManager 会 帮 有 我 们 妥善 管理 loader 及 其 加 载 的 数据 。 而 且 ，LoaderManager 还 负 
责 启 动 和 停止 oader， 以 及 管理 loader 的 生命 周期 。 怎 么 样 ? 理由 充足 吧 ! 

设备 配置 改变 后 ， 如 果 初 始 化 一 个 已 经 加 载 完 数据 的 loader， 它 能 立即 提交 数据 ， 而 不 是 再 
次 尝试 获取 数据 。 无 论 fagment 是 否 得 到 保留 ， 它 都 会 这 样 做 。 这 下 放心 多 了 ， 从 此 再 也 不 用 考 
虑 因 保留 fagment 而 产生 的 生命 周期 问题 了 。 


25.10 ”挑战 练习 : Gson 


无 论 什么 平台 ， 把 JSON 数 据 转 化 为 Java 对 象 都 是 应 用 开发 的 常见 任务 ， 如 代码 清单 25-12 所 
做 的 那样 。 于 是 ， 聪 明 的 开发 者 就 创建 了 一 些 工具 库 ， 希望 能 简化 JSON 数 据 和 Java 对 象 的 互 转 。 
Gson 就 是 这 样 的 一 个 工具 库 ( github.com/google/gson )。 不 用 写 任何 解析 代码 ，Gson 就 能 自 
动 把 JSON 数 据 映 射 为 Java 对 象 。 因 为 这 个 特性 ，Gson 现 在 是 开发 者 最 喜爱 的 JSON 解 析 库 。 
挑战 自己 ， 在 应 用 中 整合 Gson 库 ， 简 化 FLickrFetchr 中 的 JSON 解 析 。 


25.11 挑战 练习 : 分 页 


getRecent 方 法 默认 返回 一 页 包含 100 个 结果 的 数据 。 不 过 ， 该 方法 还 有 个 叫 作 page 的 参数 ， 
可 以 用 它 返 回 第 二 页 、 第 三 页 等 更 多 页 数据 。 

请 实现 一 个 RecyclerView.0nScrollListener 方 法 ， 只 要 用 户 看 完 当前 页 ， 就 使 用 下 页 返 
回 结果 替换 当前 页 。 想 更 有 挑战 的 话 ， 可 以 尝试 把 后 续 结 果 页 添加 到 当前 结果 页 后 面 。 


25.12 ”挑战 练习 : 动态 调整 网 格 列 


当前 ， 显 示 图 片 标题 的 网 格 固定 有 3 列 。 编 写 代 码 动态 调整 网 格 列 数 ， 实 现在 横 屏 或 大 屏幕 
设备 上 显示 更 多 列 标题 。 
实现 这 个 目标 有 个 简单 方法 : 分 别 为 不 同 的 设备 配置 或 屏幕 尺寸 提供 整数 修饰 资源 。 这 实际 
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和 第 17 章 中 为 不 同 尺 寸 屏 幕 提 供 不 同 布局 的 方式 差不多 。 整 数 修饰 资源 应 放置 在 res/values 目 录 
中 。 具 体 实施 细节 可 参阅 Android 开 发 者 文档 。 

提供 整数 修饰 资源 的 方式 不 太 好 确定 网 格 列 细 分 粒度 ( 只 能 赁 经 验 预先 定义 列 数 )。 下 面 再 
介绍 一 个 颇具 挑战 的 方法 : 在 fragment 的 视图 创建 时 就 计算 并 设置 好 网 格 列 数 。 显 然 ， 这 种 方式 
更 加 灵活 实用 。 基 于 RecyclerView 的 当前 宽度 和 预定 义 网 格 列 宽 ， 就 可 以 计算 出 列 数 。 

实施 前 还 有 个 问题 要 解决 :你 不 能 在 onCreateView() 方 法 中 计算 网 格 列 数 ， 因 为 这 个 时 候 
RecyclerView 还 没有 改变 。 不 过 ， 可 以 实现 ViewTree0bserver.0nGlobalLayoutListener 监 
听 需 方法 和 计算 列 数 的 onGLobatLLayout () 方 法 ， 然 后 使 用 add0nGLobaLLayoutListener() 把 
监听 器 添加 给 RecycLerview 视 网 。 
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从 Flickr 下 载 并 解析 JSON 数 据 后 ， 接 下 来 的 任务 就 是 下 载 并 显示 图 片 。 本 章 ， 我 们 来 学 习 如 
何 使 用 Looper 、Handter 和 HandterThread 动 态 下 载 和 显示 图 片 。 


26.1 配置 RecyclerView 以 显示 图 片 


在 PhotoGalleryFragment 中 ， 当 前 PhotoHolder 准 备 了 TextView 供 RecyclerView 的 
GridLayoutManager 显 示 。 每 个 TextView 显 示 一 个 GalleryItem 标 题 。 

要 显示 图 片 ， 就 要 让 PhotoHolder 提 供 ImageView。 最 终 ， 每 个 ImageView 都 应 显示 一 张 从 
GalleryItem 的 mUrl 地 址 下 载 的 图 片 。 

首先 ， 为 GalleryItem 创 建 一 个 名 为 list_item gallery.xml 的 布局 文件 。 该 布局 包含 一 
ImageView 组 件 ， 如 图 26-1 所 示 。 
































ImageView 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/item_image_view" 
android: layout_width="match_parent" 


android: layout_height="12@dp" 


android: layout_gravity="center" 





android:scaleType=" centerCrop" 


图 26-1 ”Gallery 图 片 项 布局 (res/layout/list_item gallery.xml ) 





ImageView 由 RecyclerView 的 GridLayoutManager 负 责 管理 ， 这 意味 着 其 宽度 会 变 ， 而 高 
度 固 定 。 为 最 大 化 利用 ImageView 的 空间 ， 应 设置 它 的 scaleType 属 性 值 为 centerCrop。 这 个 
属性 值 的 作用 是 先 居中 放置 图 片 ， 然 后 放大 较 小 图 片 ， 裁 剪 较 大 图 片 ( 裁 两 头 ) 以 匹配 视图 。 

接 下 来 更 新 PhotoHolder 类 ， 替 换 掉 TextView， 让 其 保存 ImageView。 同 时 ， 用 一 个 新 方 
法 替换 掉 bindGaLLeryItem() 方 法 ， 用 来 设置 ImageView 的 Drawabte， 如 代码 清单 26-1 所 示 。 
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代码 清单 26-1 更 新 PhotoHolder (PhotoGalleryFragment.java ) 


private class PhotoHolder extends RecyclerView.ViewHolder { 
private TextView mTitteTextView ImageView mItemImageView; 


public PhotoHolder(View itemView) { 
super (itemView); 


mItemImageView = (ImageView) itemView.findViewById(R.id.item image view); 


} 


Rp Sane 全 全 中 
} 


public void bindDrawable(Drawable drawable) { 
mItemImageView.setImageDrawable(drawable); 
} 
} 


之 前 ， 传 人 PhotoHotLder 构 造 方 法 的 是 TextView。 现 在 ， 新 版 本 PhotoHoLder 构 造 方法 需 
要 的 是 一 个 资源 ID 为 R.id.item_ image view 的 ImageView。 

更 新 PhotoAdapter 的 onCreateViewHolder(...) 方 法 ， 实例 化 list_item _ gallery 布局 。 然 后 
将 结果 返回 给 PhotoAdapter 的 构造 方法 ， 如 代码 清单 26- 2 所 示 。 


代码 清单 26-2 更 新 PhotoAdapter 的 onCreateViewHolder() 方 法 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 





private class PhotoAdapter extends RecyclerView.Adapter<PhotoHolder> { 


@Override 
public PhotoHolder onCreateViewHolder(ViewGroup viewGroup, int viewType) { 


return_ new PhotoeHotder (textView); 

LayoutInflater inflater = LayoutInflater.from(getActivity()); 

View view = inflater.inflate(R.layout.list item gallery, viewGroup, false); 
return new PhotoHolder (view); 


} 

现在 ， 需 要 为 每 个 ImageView 设 置 占 位 图 ， 等 成 功 下 载 图 片 后 再 做 替换 。 在 随 书 代码 文件 中 
找到 bill_up_close.png， 把 它 复 制 到 项 目的 res/drawable 目 录 中 。 

更 新 PhotoAdapter 的 onBindViewHolder() 方 法 , 使 用 占 位 图 设置 ImageView 的 Drawable， 
如 代码 清单 26-3 所 示 。 


代码 清单 26-3” 绑 定 默 认 图 片 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
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private class PhotoAdapter extends RecyclerView.Adapter<PhotoHolder> { 
@Override 
public void onBindViewHolder(PhotoHolder photoHolder, int position) { 
GalleryItem galleryItem = mGalleryItems.get(position); 


Drawable placeholder = getResources().getDrawable(R.drawable.bill up_close); 
photoHolder .bindDrawable(placeholder); 
} 


有 
运行 PhotoGallery 应 用 ，B 记 的 一 组 大 头 照 出 现 了 ， 如 图 26-2 所 示 。 


A 7:00 





PhotoGallery 








图 26-2” 满 屏 的 B 刘 大 头 照 


26.2 ”批量 下 载 缩 略 图 


当前 ，PhotoGallery 应 用 联网 代码 的 工作 方式 如 下 : PhotoGalleryFragment 执 行 一 个 
AsyncTask,， 该 AsyncTask 在 后 台 线 程 上 从 Flickr 获 取 JSON 数 据 ,， 然后 解析 JSON 并 将 解析 结果 存 
入 GalleryItem 数 组 。 最 终 每 个 GalLeryItem 都 得 到 一 个 指向 某 张 缩 略 图 的 URL。 
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接 下 来 是 下 载 这 些 URIL 指 向 的 缩 略 图 。 是 不 是 认为 只 要 在 FetchItemsTask 的 doInBackground() 
方法 中 添加 一 些 网 络 下 载 代码 就 行 了 ? GatLLeryItem 数 组 含有 100 个 URL 下 载 链 接 。 我 们 每 次 下 
载 一 张 ， 直 到 下 完 100 张 。 最 后 ， 执 行 onPostExecute(...) 方 法 ， 让 所 有 下 载 的 图 片 全 部 显示 
在 RecyclerView 视 图 中 。 

然而 ， 一 次 性 下 载 全 部 缩 略 图 存在 两 个 问题 。 首 先 ， 下 载 比 较 耗 时 ， 而 且 在 下 载 完 成 前 ， 
UI 都 无 法 完成 更 新 。 这 样 ， 网 速 较 慢 时 ， 用 户 就 只 能 对 着 B 记 的 照片 看 好 久 。 

其 次 ， 保 存 缩 略 图 也 是 个 问题 。100 张 缩 略 图 保存 在 内 存 中 国 然 轻松 ， 但 是 1000 张 呢 ? 如 果 
还 需要 实现 无 限 滚 动 来 显示 图 片 呢 7? 显然 ， 内 存 会 耗 尽 。 

考虑 到 这 类 问题 ,很 多 应 用 通常 会 选择 仅 在 需要 显示 图 片 时 才 去 下 载 。 显 然 ,RecyctLerView 
及 其 adapter 应 负责 实现 按 需 下 载 。adapter 触 发 图 片 下 载 就 放 在 onBindViewHotLder(...) 方 法 中 
实现 。 

AsyncTask 是 执行 后 台 线程 的 最 简单 方式 ， 但 它 不 适用 于 那些 重复 且 长 时 间 运 行 的 任务 。 
(具体 原因 ， 请 阅读 章 末 深 入 学 习 部 分 的 内 容 。) 

放弃 AsyncTask 吧 ， 我们 来 创建 一 个 专用 的 后 台 线 程 。 这 是 实现 按 需 下 载 的 最 常用 方式 。 


26.3 与 主线 程 通信 


虽然 我 们 打算 让 专用 线程 负责 下 载 图 片 , 但 在 无 法 与 主线 程 直接 通信 的 情况 下 , 它 是 如 何 协 
同 RecyclerView 的 adapter 来 实现 图 片 显 示 的 呢 ? 

再 次 回 到 闪电 侠 与 鞋 店 的 假想 场景 。 后 台 工 作 的 闪电 侠 已 结束 与 分 销 商 的 电话 沟通 。 他 需要 
将 库存 已 找 回 的 消息 通知 给 前 台 闪 电 侠 。 如 果 前 台 闪 电 侠 非常 忙碌 ， 后 台 闪 电 侠 就 不 能 打扰 他 。 
于 是 ， 他 选择 登记 预约 ， 等 前 台 闪 电 侠 空 闲 下 来 再 联系 。 这 虽然 可 行 ， 但 效率 不 高 。 

比较 好 的 解决 方案 是 为 每 个 闪电 使 提供 一 个 收 件 箱 。 后 台 闪 电 侠 写 下 鞋 已 人 库 的 信息 , 并 将 
其 放置 在 前 台 闪 电 侠 的 收 件 箱 顶 部 。 前 台 闪 电 侠 如 需 告 诉 后 台 闪 电 侠 库存 已 空 的 信息 , 也 可 以 这 
样 做 。 

实践 证 明 ， 收 件 箱 的 办 法 非常 好 用 。 有 了 时， 闪电 侠 可 能 需要 尽快 完成 一 项 任务 , 但 不 方便 立 
即 去 做 。 这 种 情况 下 ， 他 也 可 以 在 自己 的 收 件 箱 放 上 一 条 提醒 消息 ， 等 有 空 了 就 赶紧 去 处 理 。 

Android 系 统 中 ， 线 程 使 用 的 收 件 箱 叫 作 消 息 队 列 (message queue )。 使 用 消息 队列 的 线程 叫 
作 消 息 循环 (message loop )。 消 息 循 环 会 循环 检查 队列 上 是 否 有 新 消息 ， 如 图 26-3 所 示 。 

消息 循环 由 线程 和 looper 组 成 。Looper 对 象 管理 着 线程 的 消息 队列 。 

主线 程 就 是 个 消息 循环 , 因此 也 拥有 looper。 主线 程 的 所 有 工作 都 是 由 其 looper 完 成 的 。looper 
不 断 从 消息 队列 中 抓 取 消息 ， 然 后 完成 消息 指定 的 任务 。 

接 下 来 ， 我 们 将 创建 一 个 消息 循环 作为 后 台 线 程 。 准 备 需 要 的 looper 时 ， 我 们 会 使 用 名 为 
HandLerThread 的 类 。 
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闪电 侠 1 





闪电 侠 2 
图 26-3 ”闪电 侠 之 舞 


26.4 ”创建 并 启动 后 台 线 程 


继承 HandlerThread 类 ， 创建 一 个 名 为 ThumbnailDownloader 的 新 类 。 然 后 ， 添 加 一 个 构造 
方法 ， 一 个 名 为 queueThumbnait () 的 存根 方法 以 及 一 个 quit() 履 盖 方 法 (线程 退出 通知 方法 ， 
稍 后 会 用 到 )， 如 代码 清单 26-4 所 示 。 
代码 清单 26-4 初始 线程 代码 ( ThumbnailDownloader.java ) 


public class ThumbnailDownloader<T> extends HandLerThread { 
private static final String TAG = "ThumbnailDownloader"; 





private Boolean mHasQuit = false; 


public ThumbnailDownloader() { 
super (TAG); 
} 


@Overide 

public boolean quit() { 
mHasQuit = true; 
return super.quit(); 


public void queueThumbnail(T target, String urL) { 
Log.i(TAG, "Got a URL: " + url); 
} 


26.4 创建 并 局 动 后 台 线 程 ”425 











注意 , ThumbnailDownloader 类 使 用 了 <T> 泛 型 参数 。 ThumbnailDownloader 类 的 使 用 者 (这 
里 指 PhotoGalleryFragment) ， 需 要 使 用 某 些 对 象 来 识别 每 次 下 载 ， 并 确定 该 使 用 已 下 载 图 片 
更 新 哪个 UI 元 素 。 有 了 泛 型 参数 ， 实 施 起 来 方便 了 很 多 。 

queueThumbnail() 方 法 需要 一 个 T 类 型 对 象 (标识 具体 哪 次 下 载 ) 和 一 个 String 参 数 ( URL 
下 载 链接 ), 同时 , 它 也 是 PhotoAdapter 在 其 onBindViewHolder(...) 实 现 方法 中 要 调用 的 方法 。 

打开 PhotoGalleryFragment.java 文件 ， 为 PhotoGalleryFragment 添加 一 个 ThumbnaitL- 
DownLloader 类 型 的 成 员 变量 。 然 后 ， 在 onCreate(...) 方 法 中 ,创建 并 启动 线程 。 最 后 ， 和 覆盖 
onDestroy() 方 法 退出 线程 ， 如 代码 清单 26-5 所 示 。 
代码 清单 26-5 ”创建 ThumbnailDownloader (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 














private static final String TAG = "PhotoGalleryFragment"; 


private RecyclerView mPhotoRecyclerView; 
private List<GalleryItem> mItems = new ArrayList<>(); 
private ThumbnailDownloader<PhotoHolder> mThumbnailDownloader; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setRetainInstance(true); 
new FetchItemsTask() .execute() ; 





mThumbnailDownloader = new ThumbnailDownloader<>(); 
mThumbnailDownloader.start(); 
mThumbnailDownloader .getLooper(); 
Log.i(TAG, "Background thread started"); 
} 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


} 


@Override 
public void onDestroy() { 
super.onDestroy(); 
mThumbnailDownloader .quit(); 
Log.i(TAG, "Background thread destroyed"); 


} 

ThumbnailDownloader 的 泛 型 参数 支持 任何 对 象 ， 但 在 这 里 ，PhotoHolder 最 合适 ， 因 为 该 
视图 是 最 终 显示 下 载 图片 的 地 方 。 

上 述 代码 有 两 点 安全 考虑 ， 值 得 一 说 。 
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口 ThumbnailDownLloader 的 getLooper() 方 法 是 在 start() 方 法 之 后 调用 的 。( 稍 后 会 学 习 更 
多 有 关 Looper 的 知识 。) 这 能 保证 线程 就 绪 ， 避 免 潜 在 竞争 (尽管 极 少 发 生 )。 因 为 
getLooper() 方 法 能 执行 成 功 ， 说 明 onLooperPrepared() 方 法 肯定 早已 完成 。 这 样 ， 
queueThumbnail() 方 法 因 Handler 为 空 而 调用 失败 的 情况 就 能 避免 了 。 

口 在 onDestroy() 方 法 内 调用 quit() 方 法 结束 线程 。 这 非常 关键 。 如 不 终止 Handler- 
Thread， 它 会 一 直 运 行 下 去 ， 成 为 僵尸 

最 后 , 在 PhotoAdapter.onBindViewHolder(...) 方 法 中 , 调用 线程 的 queueThumbnail() 

方法 ， 站 信 从 没 这 国语 鸭 BiOtGNO UerHiCa Leite RE 如 代码 清单 26-6 所 示 。 


代码 清单 26-6 ”让 ThumbnailDownLloader 跑 起 来 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 





























private class PhotoAdapter extends RecyclerView.Adapter<PhotoHolder> { 


@Override 

public void onBindViewHolder(PhotoHolder photoHolder, int position) { 
GalleryItem galleryItem = mGalleryItems.get(position); 
Drawable placeholder = getResources().getDrawable(R.drawable.bill up close); 
photoHolder.bindDrawable(placeholder); 
mThumbnailDownloader .queueThumbnail (photoHolder, galleryItem.getUr1()); 


} 

运行 PhotoGallery 应 用 并 查看 LogCat 窗 口 。 在 RecyclerView 视 图 中 滑动 时 ， 可 看 到 
ThumbnailDownLloader 正 在 后 台 处 理 各 个 下 载 请 求 。 

成 功 创建 并 运行 HandtlerThread 线 程 后 ， 接 下 来 的 任务 是 : 使 用 传人 queueThumbnaitL() 方 
法 的 信息 创建 消息 ， 并 放置 在 ThumbnailDownloader 的 消息 队列 中 。 























26.5 Message 与 message handler 

















创建 消息 前 ， 首 先 要 理解 什么 是 Message， 以 及 它 与 Handler (或 者 说 message handler ) 之 
间 的 关系 。 


26.5.1 剖析 Message 


首先 来 看 消息 。 闪 电 侠 收 件 箱 里 的 消息 是 需要 处 理 的 各 种 任务 消息 。 “你 跑 得 真 快 !” 这 样 
的 鼓励 消息 是 没 空 写 的 。 
消息 是 Message 类 的 一 个 实例 ， 它 有 好 几 个 实例 变量 ， 其 中 有 三 个 需要 你 定义 。 
D what: 用 户 定义 的 int 型 消息 代码 ， 用 来 描述 消息 。 
口 obj : 用 户 指 定 ， 随 消息 发 送 的 对 象 。 























26.5 Message 与 message handler 427 








D target: 处 理 消 息 的 Handler。 

Message 的 目标 (target ) 是 一 个 Handler 类 实例 。Handler 可 看 作 message handler 的 简称 。 创 
建 Message 时 ， 它 会 自动 与 一 个 HandtLer 相 关联 。Message 待 处 理 时 ，HandtLer 对 象 负责 触发 消 
息 处 理事 件 。 


26.5.2 剖析 HandtLer 


要 处 理 消 息 以 及 消息 指定 的 任务 ， 首 先 需 要 一 个 HandLer 实 例 。HandtLer 不 仅仅 是 处 理 
Message 的 目标 (target )， 也 是 创建 和 发 布 Message 的 接口 ， 如 图 26-4 所 示 。 


























MessageQueue 








HandlerThread 


图 26-4 Looper、Handler、HandlerThread 和 Message 


Looper 拥 有 Message 对 象 的 收 件 箱 ， 所 以 Message 必 须 在 Looper 上 发 布 或 处 理 。 既 然 有 这 层 
关系 ， 为 协同 工作 ，Handler 总 是 引用 着 Looper。 

一 个 Handter 仅 与 一 个 Looper 相 关联 ， 一 个 Message 也 仅 与 一 个 目标 HandtLer (也 称 作 
Message 目 标 ) 相关 联 ， 如 图 26-$ 所 示 。Looper 拥 有 整个 Message 队 列 。 多 个 Message 可 以 引用 
同一 目标 Handler。 





MessageQueue 


Handler #1 





Message 





Handler #2 





Handler #3 








HandlerThread 








图 26-5 ”多 个 Handler 对 应 一 个 Looper 
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多 个 Handler 也 可 与 一 个 Looper 相 关联 。 这 意味 着 一 个 Handler 的 Message 可 能 与 男 一 个 
Handler 的 Message 存 放 在 同一 消息 队列 中 。 


26.5.3 ”使 用 handler 


一 般 来 计 ， 不 应 手动 设置 消息 的 目标 Handtler。 创 建 信息 时 ， 最 好 调用 Handler. obtain- 
Message (...) 方 法 。 传 入 其 他 必要 消息 字段 后 ， 该 方法 会 ee 

为 避免 反复 创建 新 的 Message 对 象 Handler.obtainMessage(...) 方 法 会 从 公共 回收 池 里 
获取 消息 。 相 比 创 建新 实例 ， 这 样 更 加 高 效 。 

一 旦 取得 Message， 就 可 以 调用 sendToTarget() 方 法 将 其 发 送 给 它 的 Handler。 然 后 ， 
Handler 会 将 这 个 Message 放 置 在 Looper 消 息 队 列 的 尾部 。 

对 于 PhotoGallery 应 用 ， 我 们 会 在 queueThumbnail() 实 现 方 法 中 获取 并 发 送 消息 给 它 的 目 
标 。 消 息 的 what 属 性 是 一 个 定义 为 MESSAGE_DOWNLOAD 的 常量 。 消 息 的 obj 属 性 是 一 个 T 类 型 对 象 ， 
这 里 指 由 adapter 传 人 queueThumbnail() 方 法 的 PhotoHolder， 用 于 标识 下 载 。 

Looper 取 得 消息 队列 中 的 特定 消息 后 ， 会 将 它 发 送 给 消息 的 目标 Handler 去 处 理 。 消 息 一 般 
是 在 目标 Handler 的 HandLer,handLeMessage(.,,) 实 现 方法 中 进行 处 理 的 。 

图 26-6 展 示 了 其 中 的 对 象 关系 。 









































MessageQueue MessageQueue 


MessageQueue 


My New 
Message 


My Handler Message My Handler Message My Handler oH Message 
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Looper 
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HandlerThread HandlerThread HandlerThread 


图 26-6 ”创建 并 发 送 Message 


















































这 里 ， 稍 后 要 创建 的 handleMessage(...) 实 现 方法 将 使 用 FLickrFetchr 从 URL 下 载 图 片 
字 节 数据 ， 然 后 再 转换 为 位 图 。 
始 写 代码 ， 首 先 添 加 一 些 常 量 和 成 员 变 量 ， 如 代码 清单 26-7 所 示 。 
代码 清单 26-7 添加 一 些 常量 和 成 员 变 量 (ThumbnailDownloader.java ) 


public class ThumbnailDownloader<T> extends HandlerThread { 
private static final String TAG = "ThumbnailDownloader"; 
private static final int MESSAGE DOWNLOAD = 0; 
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private boolean mHasQuit = false; 
private Handler mRequestHandler; 
private ConcurrentMap<T,String> mRequestMap = new ConcurrentHashMap<>(); 


上 


MESSAGE_DOWNLOAD 用 来 标识 下 载 请 求 消 息 。(ThumbnaitLDowntLoader 会 把 它 设 为 任何 新 创 
建 下 载 消息 的 what 属 性 。) 
新 添加 的 mRequestHandler 用 来 存储 对 Handtler 的 引用 。 这 个 Handtler 负 责 在 Thumbnail 
DownLloader 后 人 台 线 程 上 管理 下 载 请 求 消息 队列 。 还 负责 从 消息 队列 里 取出 并 处 理 下 载 请 求 消息 。 

新 添加 的 mRequestMap 是 个 ConcurrentHashMap。 这 是 一 种 线程 安全 的 HashMap。 这 里 , 使 
用 一 个 标记 下 载 请 求 的 T 类 型 对 象 作为 key， 我 们 可 以 存 取 和 请 求 关 联 的 URL 下 载 链 接 。( 这 个 标 
记 对 和 象 是 PhotoHolder， 下 载 结果 就 能 很 方便 地 发 送 给 显示 图 片 的 UI 元 素 。) 

接 下 来 ， 在 queueThumbnail(...) 方 法 中 添加 代码 ， 更 新 mRequestMap 并 把 下 载 消 息 放 到 
后 台 线 程 的 消息 队列 中 去 ， 如 代码 清单 26-8 所 示 。 


代码 清单 26-8 获取 和 发 送 消息 (ThumbnailDownloader.java ) 


public class ThumbnailDownloader<T> extends HandlerThread { 
private static final String TAG = "ThumbnailDownloader"; 
private static final int MESSAGE DOWNLOAD = 0; 







































































private boolean mHasQuit = false; 
private Handler mRequestHandler; 
private ConcurrentMap<T,String> mRequestMap = new ConcurrentHashMap<>(); 


public ThumbnailDownloader() { 
super (TAG); 
} 


@Override 

public boolean quit() { 
mHasQuit = true; 
return super.quit(); 


} 


public void queueThumbnail(T target, String url) { 
Log.i(TAG, "Got a URL: " + url); 


if (url == nuLL) { 
mRequestMap. remove (target); 
} elsef{ 
mRequestMap.put (target, url); 
mRequestHandler .obtainMessage (MESSAGE DOWNLOAD, target) 
.SendToTarget(); 


} 
从 mRequestHandler 直 接 获 取 到 消息 后 , mRequestHandler 也 就 自动 成 为 了 这 个 新 Message 
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对 象 的 target。 这 表明 mRequestHandler 会 负 
的 what 


























它 的 obj 属性 是 传递 给 





为 性 是 MESSAGE DOWNLOAD 。 


target 值 (这 里 指 PhotoHolder )。 


新 消息 
PhotoGalleryFragment 六 RecyclerView 的 adapter 就 是 从 onBindViewHolder( 
URL 传 给 PhotoHolder 的 。 

有 PhotoHolder 和 URL 的 对 应 关系 更 新 





用 queueThumbnail(...)， 把 待 下 载 图 片 及 划 
注意 ， 消 息 自身 不 et 息 。 我 们 的 做 法 是 使 有 





mRequestMap 。 随 后 ， 我 们 会 从 mRequestMap 中 取出 
PhotoHoLder 实 例 的 最 新 下 载 请 求 URL。( ; 

















不 断 回收 重用 的 。) 
最 后 , 初始 化 mRequestHandLer 并 定义 该 HandtLer 在 得 到 消息 队列 中 的 下 载 消 息 后 应 执行 
任务 ， 如 代码 清单 26-9 所 示 。 


代码 清单 26-9 处 理 消 息 (ThumbnailDownloaderjava ) 


public class ThumbnailDownloader<T> extends HandlerThread { 


private static final String TAG = 
private static final int MESSAGE DOWNLOAD = 0; 


private boolean mHasQuit = false; 
private Handler mRequestHandler; 
private ConcurrentMap<T,String> mRequestMap = 


public ThumbnailDownloader() { 


super (TAG); 
上 
@Override 
protected void onLooperPrepared() { 
mRequestHandler = new Handler() { 
@Override 
public void handleMessage(Message msg) { 
if (msg.what == MESSAGE DOWNLOAD) { 
T target = (T) msg.obj; 
Log.i(TAG, "Got a request for URL: 
handleRequest (target); 
} 
} 
}; 
} 
@Override 
Public boolean quit(){ 
mHasQuit = true; 
return super.quit(); 
} 


public void queueThumbnail(T target, String url) { 


责 处 理 从 消息 队列 中 取出 的 这 个 消息 


图 片 URL ， 
这 很 重要 ， 因 为 RecyclerView 中 的 ViewHolder 是 


AF queueThumbnail(. 




















以 保证 总 是 使 用 了 匹配 











\。 这 个 消息 
.) 方 法 的 T 


\ 就 代表 指定 为 T target (RecyclerView 中 的 PhotoHolder ) 的 下 载 请 求 。 还 记得 吗 ? 
, ) 方 法 里 调 





人 








"ThumbnailDownloader"; 


new ConcurrentHashMap<>(); 


”+ mRequestMap.get(target)); 


Rs 


了 的 
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} 


private void handleRequest(final T target) { 


try { 
final String url = mRequestMap.get(target); 


if (url == nuLL) { 
return; 


} 


byte[] bitmapBytes = new FlickrFetchr().getUrlBytes (url); 
final Bitmap bitmap = BitmapFactory 

.decodeByteArray (bitmapBytes, 0, bitmapBytes.Tlength); 
Log.i(TAG, "Bitmap created"); 


} catch (IOException ioe) { 
Log.e(TAG, "Error downloading image", ioe); 


} 


} 
上 述 代 码 中 ， 我 们 是 在 onLooperPrepared() 方 法 里 实现 Handler.handleMessage(...) 方 法 





的 。HandlerThread .onLooperPrepared () 是 在 Looper 首 次 检查 消息 队列 之 前 调用 ， 所 以 该 方 26 








法 是 创建 HandLer 实 现 的 好 地 方 。 

在 Handler.handleMessage(...) 方 法 中 ， 首 先 检 查 消息 类 型 ， 再 获取 obj 值 (T 类 型 下 载 

请 求 )， 然后 将 其 传递 给 handleRequest(. . ) 方 法 处 理 。( 前 面 说 过 ， 队 列 中 的 下 载 消 息 取出 并 

可 以 处 理 时 ， 就 会 触发 调用 Handler. ee , ) 方 法 。) 

handleRequest() 方 法 是 下 载 执 行 的 地 方 。 在 这 里 ， 确认 URL 有 效 后 ， 就 将 它 传递 给 
FlickrFetchr 新 实例 。 确 切 地 说 ， 此 处 使 用 的 是 上 一 章 中 创建 的 FlickrFetchr.getUrlBytes(...) 

最 后 ， 使 用 BitmapFactory 把 getUrlBytes(...) 返 回 的 字 节 数组 转换 为 位 图 。 

运行 PhotoGallery 应 用 ， 通过 LogCat 窗 口 的 日 志 确 认 代码 工作 正常 。 

当然 ， 在 将 位 图 设置 给 PhotoHolder 视 图 (来 自 于 PhotoAdapter ) 之 前 ， 请 求 处 理 还 不 算 
完 。 不 过 这 是 UI 的 工作 。 因 此 ， 必 须 回 到 主线 程 上 完成 它 。 

目前 为 止 ， 所 有 的 工作 就 是 在 线程 上 使 用 handLer 和 消息 一 一 ThumbnaiLDowntLoader 把 消 
息 放 入 自己 的 收 件 箱 。 下 一 节 要 学 习 的 内 容 是 : ThumbnaitLDowntoader 如 何 使 用 HandtLer 向 主 
线程 发 请 求 。 


























下 





















































26.5.4 传递 handler 


当前 ， 使 用 ThumbnaiLDowntoader 的 mRequestHandter， 我 们 已 可 以 从 主线 程 安排 后 台 线 
程 任务 ， 如 图 26-7 所 示 。 
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mRequest- | 


mResponseHandler Handler 


图 26-7 “从 主线 程 安 排 ThumbnaiLDowntoader 上 的 任务 


反 过 来 , 也 可 以 从 后 台 线 程 使 用 与 主线 程 关 联 的 Handler, 安排 主线 程 任 务 ， 如 图 26-8 所 示 。 

主线 程 是 一 个 拥有 handler 和 Looper 的 消息 循环 。 主 线程 上 创建 的 HandtLer 会 自动 与 它 的 
Looper 相 关联 。 主 线程 上 创建 的 这 个 HandLer 也 可 以 传递 给 另 一 线程 。 传 递 出 去 的 HandtLer 与 创 
建 它 的 线程 Looper 始 终 保持 着 联系 。 因 此 , 已 传 出 HandtLer 负 责 处 理 的 所 有 消息 都 将 在 主线 程 的 
消息 队列 中 处 理 。 



































“完成 了 ! 现在 去 设置 
该 ImageView 上 的 图 片 ” 


2 ThumbnailDownloader 


mm 


| 


Handler 





mResponseHandler 
图 26-8 ”从 ThumbnailDownloader 线 程 上 规划 主线 程 任务 


在 ThumbnailDownloader.java 中 ， 添 加 上 图 中 的 mResponseHandler 变 量 ,， 以 存放 来 自 于 主 
线程 的 HandLer。 然 后 ， 以 一 个 能 接受 HandtLer 的 构造 方法 替换 原 构 造 方 法 ， 并 设置 变量 的 值 。 
最 后 新 增 一 个 监听 器 接口 响应 请 求 ( 主线 程 发 请 求 , 响应 结果 是 下 载 的 图 片 ), 如 代码 清单 26-10 
所 示 。 
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代码 清单 26-10 ”处 理 消息 (ThumbnailDownloader.java ) 


public class ThumbnailDownloader<T> extends HandlerThread { 
private static final String TAG = "ThumbnailDownloader"; 
private static final int MESSAGE DOWNLOAD = 0; 


private boolean mHasQuit = false; 

private Handler mRequestHandler; 

private ConcurrentMap<T,String> mRequestMap = new ConcurrentHashMap<>(); 
private Handler mResponseHandler; 

private ThumbnailDownloadListener<T> mThumbnailDownloadListener; 


public interface ThumbnailDownloadListener<T> { 
void onThumbnailDownloaded(T target, Bitmap thumbnail); 


} 


public void setThumbnailDownloadListener(ThumbnailDownloadListener<T> listener) { 
mThumbnailDownloadListener = listener; 


} 


public ThumbnailDownloader(Handler responseHandler) { 
super (TAG); 
mResponseHandler = responseHandler; 


} 


在 图 片 下 载 完 成 ， 可 以 交 给 UI 去 显示 时 ， 定 义 在 ThumbnailDownloadListener 新 接口 中 的 
onThumbnailDownloaded(...) 方 法 就 会 被 调用 。 稍 后 ， 为 了 把 下 载 任务 和 UI 更 新 任务 (把 图 片 
放 和 人 ImageView ) 分 开 ， 代 替 ThumbnaiLDowntoader， 我 们 会 使 用 这 个 监听 器 方法 把 处 理 已 下 载 
图 片 的 任务 委托 给 另 一 个 类 ( 这 里 指 PhotoGaLLeryFragment )。 这 样 ，ThumbnailDownloader 
就 可 以 把 下 载 结果 传 给 其 他 视图 对 象 。 

接 下 来 ， 修 改 PhotoGalleryFragment 类 ， 将 主线 程 关 联 的 Handler 传 递 给 ThumbnailDown- 
Loader。 另外 , 再 设置 一 个 ThumbnailDownLloadListener 处 理 已 下 载 图 片 , 如 代码 清单 26-11 所 示 。 


代码 清单 26-11 使 用 反馈 Handler (PhotoGalleryFragment.java ) 


GOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setRetainInstance(true); 
new FetchItemsTask() .execute() ; 

































































Handler responseHandler = new Handler(); 
mThumbnailDownloader = new ThumbnailDownloader<>(responseHandler); 
mThumbnailDownloader.setThumbnailDownloadListener( 
new ThumbnailDownloader.ThumbnailDownloadListener<PhotoHolder>() { 
@Override 
public void onThumbnailDownloaded(PhotoHolder photoHolder, Bitmap bitmap) { 
Drawable drawable = new BitmapDrawable(getResources(), bitmap); 
photoHolder .bindDrawable (drawable); 
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) 

mThumbnailDownloader. start(); 

mThumbnailDownloader.getLooper(); 

Log.i(TAG, "Background thread started"); 
} 


前 面 说 过 ，Handler 默 认 与 当前 线程 的 Looper 相 关联 。 这 个 Handler 是 在 onCreate(...) 方 
法 中 创建 的 ， 所 以 它 会 与 主线 程 的 Looper 相 关联 。 
现在 ， 通 过 mResponseHandler，ThumbnailDownloader 能 够 使 用 与 主线 程 Looper 绑 定 的 
Handtler。 同时 , 还 有 ThumbnailDownloadListener 使 用 返回 的 Bitmap 执 行 UI 更 新 操作 。 具 体 来 说 ， 
就 是 通过 onThumbnailDowntloaded 实 现 ， 使 用 新 下 载 的 Bitmap 来 设置 PhotoHolder 的 Drawable。 
和 在 后 台 线 程 上 把 图 片 下 载 请 求 放 入 消息 队列 类 似 ， 我们 也 可 以 发 送 定制 Message 给 主线 
程 ， 要求 显示 已 下 载 图 片 。 不 过 ， 这 需要 男 一 个 Handler 子 类 ， 以 及 一 个 handleMessage(...) 

盖 方 法 。 
方便 起 见 ， 我 们 转 而 使 用 男 一 个 Handler 方 法 一 一 post (Runnable)。 
Handler.post(Runnable) 是 一 个 发 布 Message 的 便利 方法 。 示 例如 下 : 


Runnable myRunnable = new Runnable() { 
@Override 
public void run() { 
/* Your code here */ 















































} 
}; 
Message m = mHandler.obtainMessage(); 
m.callback = myRunnable; 


Message 设 有 回调 方法 属性 后 ， 取 出 队列 的 消息 是 不 会 发 给 target Handler 的 。 相 反 ， 存 
储 在 回调 方法 中 的 Runnable 的 run() 方 法 会 直接 执行 。 
在 ThumbnailDownloader.handleRequest() 方 法 中 ， 添 加 代码 清单 26-12 所 示 代 码 。 


代码 清单 26-12 ”图 片 下 载 与 显示 (ThumbnailDownloader.java ) 


public class ThumbnailDownloader<T> extends HandlerThread { 





private Handler mResponseHandler; 
private ThumbnailDownloadListener<T> mThumbnailDownloadListener; 


private void handleRequest(final T target) { 


try { 
final String url = mRequestMap.get(target); 


if (url == null) { 
return; 


} 


byte[] bitmapBytes = new FlickrFetchr().getUrlBytes (url); 
final Bitmap bitmap = BitmapFactory 

.decodeByteArray(bitmapBytes, 0, bitmapBytes.length); 
Log.i(TAG, "Bitmap created"); 
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mResponseHandler.post(new RunnabLe() { 
public void run() { 
if (mRequestMap.get(target) != url || 
mHasQuit) { 
return; 


} 


mRequestMap. remove (target); 
mThumbnailDownloadListener.onThumbnailDownloaded(target, bitmap); 
} 
}); 


} catch (IOException ioe) { 
Log.e(TAG, "Error downloading image", ioe); 


} 
} 


因为 mResponseHandler 与 主线 程 的 Looper 相 关联 ， 所 以 UI 更 新 代码 会 在 主线 程 中 完成 。 

那么 上 述 代 码 有 什么 作用 呢 ? 首先 , 它 再 次 检查 requestMap。 这 很 有 必要 , 因为 RecycterView 
会 循环 使 用 其 视图 。 在 ThumbnaitLDowntLoader 下 载 完 成 Bitmap 之 后 , RecyclerView 可 能 循环 使 
用 了 PhotoHolder 并 相应 请 求 了 一 个 不 同 的 URL。 该 检查 可 保证 每 个 PhotoHolder 都 能 获取 到 正 26 
确 的 图 片 ， 即 使 中 间 发 生 了 其 他 请 求 也 无 妨 。 

接 下 来 ， 检 查 mHasQuit 值 。 如 果 ThumbnaitLDowntoader 已 经 退出 ， 运 行 任何 回调 方法 可 能 
都 不 太 安 全 。 

最 后 , 从 requestMap 中 删除 配对 的 PhotoHoLder-URL , 然后 将 位 图 设置 到 目标 PhotoHolder 上 。 

在 运行 应 用 并 欣赏 图 片 前 ,还 应 考虑 一 个 风险 点 。 如 果 用 户 旋转 屏幕 ， 因 PhotoHolder 视 图 
的 失效 ，ThumbnailDownloader 可 能 会 挂 起 。 如 果 点 击 这 些 ImageView， 就 会 发 生 异常 。 
新 增 cLearQueue () 方 法 清除 队列 中 的 所 有 请 求 ， 如 代码 清单 26-13 所 示 。 


代码 清单 26-13 ”添加 清理 方法 ( ThumbnailDownloader.java ) 


public class ThumbnailDownloader<T> extends HandlerThread { 









































public void queueThumbnail(T target, String url) { 
} 


public void clearQueue() { 
mRequestHandler.removeMessages (MESSAGE_DOWNLOAD); 
mRequestMap.clear(); 


} 


private void handleRequest(final T target) { 


} 
} 


既然 视图 已 销毁 ， 别 忘 了 在 PhotoGaLteryFragment 中 清空 ThumbnaiLDowntoader， 如 代 
码 清单 26-14 所 示 。 
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代码 清单 26-14 调用 清理 方法 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 


GOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


} 


@Override 

public void onDestroyView() { 
super .onDestroyView(); 
mThumbnailDownloader .clearQueue(); 


} 


@Override 
public void onDestroy() { 


} 


至 此 ， 本 章 的 所 有 任务 都 完成 了 。 运 行 PhotoGallery 应 用 ， 滚 动 屏 幕 查看 图 片 的 动态 加 载 。 
PhotoGallery 应 用 有 了 下 载 并 显示 图 片 的 基本 功能 。 接 下 来 的 几 章 还 会 为 应 用 添加 更 多 功能 ， 
如 搜索 图 片 、 在 Web 视 图 中 打开 图 片 所 在 的 Flickr 网 页 等 。 


26.6 























深入 学 习 : AsyncTask 与 线程 


理解 了 Handler 和 Looper 之 后 , AsyncTask 也 就 没有 当初 看 上 去 那么 神奇 了 。 不 过 就 本 章 所 








做 的 线程 相关 工作 来 看 ， 要 用 AsyncTask 能 省 不 少 事 。 那 么 为 什么 要 用 HandlerThread, 而 不 用 


它 呢 ? 


原因 有 好 几 个 。 最 基本 的 一 个 是 AsyncTask 的 工作 方式 并 不 适用 于 本 章 的 使 用 场景 。 它 主要 
应 用 于 那些 短暂 且 较 少 重复 的 任务 。 上 一 章 的 应 用 场景 才 是 AsyncTask 大 展 身 手 的 地 方 。 如 果 创 





























建 了 大 量 的 AsyncTask， 或 者 长 时 间 在 运行 AsyncTask， 那 么 很 可 能 就 是 错 用 了 它 。 

有 一 个 技术 层面 的 理由 更 让 人 信服 : 在 Android 3.2 系 统 版 本 中 ，AsyncTask 的 内 部 实现 有 了 
重大 变化 。 自 Android 3.2 版 本 起 ,AsyncTask 不 再 为 每 一 个 AsyncTask 实 例 单独 创建 线程 。 相反 ， 
它 使 用 一 个 Executor 在 单一 的 后 台 线 程 上 运行 所 有 AsyncTask 后 台 任 务 。 这 意味 着 每 个 





Async 


使 用 一 个 线程 池 executor 虽 然 可 安全 地 并 发 运行 多 个 AsyncTask， 但 不 推荐 这 么 做 。 如 果真 














Task 都 需要 排队 顺序 执行 。 显 然 ， 长 时 间 运 行 的 AsyncTask 会 阻塞 其 他 AsyncTask。 

















的 考虑 这 么 做 ， 最 好 自己 处 理 线程 相关 的 工作 ， 必 要 时 就 使 用 HandtLer 与 主线 程 通信 。 


26.7 


深入 学 习 : 解决 图 片 下 载 问题 





本 书 使 用 的 都 是 Android 官 方 库 中 的 工具 。 如 有 需要 ， 还 可 以 使 用 各 种 第 三 方 库 。 这 些 库 专 
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用 于 一 些 特定 场景 ( 比如 PhotoGallery 中 的 图 片 下 载 )， 可 以 节约 大 量 开 发 时 间 。 
必须 承认 ，PhotoGallery 应 用 的 图 片 下 载 解 决 方案 远 不 够 完美 。 如 果 还 想 优 化 性 能 ， 实 现 棘 
手 的 缓存 功能 , 很 自然 就 会 想到 是 否 别人 已 有 更 好 的 解决 方案 。 答案 是 肯定 的 。 有 好 几 个 高 性 能 
图 片 下 载 库 可 供 使 用 。 例如 , 在 开发 生产 应 用 时 , 我 们 就 用 了 Picasso 库 ( square.github.io/ picasso/ )。 
使 用 Picasso 库 ， 一 条 语句 就 能 实现 本 章 的 图 片 下载 功 能 : 


private class PhotoHolder extends RecyclerView.ViewHolder { 















































public void bindGalleryItem(GalleryItem galleryItem) { 
Picasso.with(getActivity()) 
.load(galleryItem.getUrl()) 
.placeholder(R.drawable.bill up close) 
.Into(mItemImageView) ; 


} 
上 述 代码 中 ， 流 接口 需要 使 用 with(Context) 指 定 一 个 context。tLoad(String) 用 于 指定 要 
下 载 图 片 的 URL。into(ImageView) 用 于 指定 加 载 下 载 结果 的 ImageView 对 象 。 当 然 ， 还 有 一 些 
其 他 配置 选项 可 用 ,比如 指定 占 位 图 片 (使 用 placeholder(int) 和 placeholder(drawable) )。 26 
在 PhotoGallery 应 用 中 , 只 要 引入 Picasso 依 赖 库 , 并 在 PhotoAdapter.onBindViewHolder(...) 
方法 中 用 bindGatLeryItem( .. . ) 方 法 替换 原 有 代码 ， 就 用 上 了 Picasso 库 的 强大 下 载 功 能 。 
Picasso 包 办 了 ThumbnaiLDowntoader (还 有 ThumbnailDownloader.ThumbnailDownload- 
Listener<T> 回 调 方法 ) 的 所 有 工作 以 及 FlickrFetchr 中 的 图 片 处 理 相关 工作 ， 所 以 可 以 直接 
删除 ThumbnaiLDowntLoader 实 现 ( FLickrFetchr 中 的 JSON 数 据 下 载 还 是 需要 的 ), 使 用 Picasso， 
不 仅 能 简化 代码 ， 还 能 轻松 使 用 它 的 图 片 动画 、 磁 盘 缓 存 等 高 级 功能 。 
可 以 在 项 目 结构 窗口 中 将 Picasso 作 为 库 依赖 项 添加 在 项 目 中 ， 就 像 添 加 RecyclerView 等 其 他 
依赖 项 一 样 。 
当然 ，Picasso 也 不 是 万 能 的 ,为 追求 小 而 美 , 它 也 有 功能 取舍 ， 比 如 ， 它 无 法 文 持 下 载 动态 
图 片 。 如 果 你 有 这 个 需求 , 可 以 考虑 使 用 Google 的 Glide 或 Facebook 的 Fresco。 它们 各 有 特点 , Glide 
比较 小 巧 ，Fresco 性 能 好 。 


















































26.8 深入 学 习 : StrictMode 


开发 应 用 时 , 有 些 东西 最 好 要 避免 , 比如 , 让 应 用 月 江 的 代码 漏洞 、 安 全 漏洞 等 。 举例 来 讲 ， 
网 络 条 件 不 好 的 情况 下 ， 在 主线 程 上 发 送 网 络 请 求 很 可 能 就 会 导致 设备 出 现 ANR 错 误 。 

表现 在 后 台 的 话 ， 你 应 该 会 看 到 Network0nMainThread 异 常 以 及 其 他 大 量 日 志 信 息 。 这 实 
际 是 StrictMode 就 错误 在 警告 你 。Android 引 入 的 StrictMode 可 以 帮助 开发 者 探测 代码 问题 。 像 在 
主线 程 上 发 起 网 络 请 求 、 编 码 漏洞 以 及 安全 漏洞 这 样 的 问题 都 是 它 探测 的 对 象 。 

无 需 配 置 ，StrictMode 就 会 阻止 在 主线 程 上 发 起 网 络 请 求 这 样 的 代码 问题 。 它 还 能 探测 影响 
系统 性 能 的 代码 问题 , 想 启用 StrictMode 默 认 防 御 策 略 的 话 ,调用 StrictMode.enableDefaults() 
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方法 就 行 了 ( developer.android.com/reference/android/os/StrictMode.html#enableDefaults() )。 

一 旦 调用 了 StrictMode.enableDefaults() 方 法 ， 如 果 代 码 有 相关 问题 ， 就 能 在 Logcat 看 
到 以 下 提醒 : 
口 在 主线 程 上 发 起 网 络 请 求 
口 在 主线 程 上 做 了 磁盘 读 写 
口 Activity 未 及 时 销毁 ( 又 称 为 activity 泄 露 ) 
口 SQLite 数 据 库 游标 未 关闭 
口 网 络 通 信使 用 了 明文 (未 使 用 SSL/TLS 加 密 ) 

假如 应 用 违反 了 防御 策略 ， 你 想 定制 应 对 行为 ， 可 使 用 ThreadPolicy.Builder 和 
VmPolicy .Builder 类 定制 。 你 可 以 定制 的 应 对 行为 有 : 控制 是 否 抛 出 异常 ， 弹 出 对 话 框 或 是 日 
志 记 录 违 反 策略 警示 信息 。 


26.9 ”挑战 练习 : 预 加 载 以 及 缓存 


应 用 中 并 非 所 有 任务 都 能 即时 完成 ， 对 此 ， 大 多 用 户 表 示 理 解 。 不 过 ， 即 使 是 这 样 ， 开 发 者 
们 也 一 直 在 努力 做 到 最 好 。 

为 了 让 应 用 反应 更 快 ， 大 多 数 严肃 应 用 都 可 以 采用 以 下 方式 : 增加 缓存 层 ， 预 加 载 图 片 。 

缓存 指 存储 一 定数 目 Bitmap 对 象 的 地 方 。 这 样 ， 即 使 不 再 使 用 这 些 对 象 ， 它 们 也 依然 存储 
在 那里 。 缓存 的 存储 空间 有 限 ， 因 此 ,在 缓存 空间 用 完 的 情况 下 , 需要 某 种 策略 对 保存 的 对 象 做 
一 定 的 取舍。 许多 缓存 机 制 使 用 一 种 叫 作 LRU ( leastrecently used， 最 近 最 少 使 用 ) 的 存储 策略 。 
基于 该 种 策略 ， 当 存储 空间 用 尽 时 ,缓存 会 清除 最 近 最 少 使 用 的 对 象 。 

Android 支 持 库 中 的 LruCache 类 实现 了 LRU 缓 存 策略 。 作 为 第 一 个 练习 ， 请 使 用 LruCache 
为 ThumbnaitDownloader 增 加 简单 的 缓存 功能 。 这样 ,每 次 下 载 完 Bitmap 时 , 将 其 存 人 缓存 中 。 
随后 ， 准 备 下 载 新 图 片 时 ， 应 首先 查看 缓存 ， 确 认 是 否 已 经 有 了 。 

缓存 实现 完成 后 ， 即 可 使 用 它 进行 预 加载 。 预 加 载 是 指 在 实际 使 用 对 象 前 ,就 预先 将 它 加 载 
到 缓存 中 。 这 样 ， 在 显示 Bitmap 时 ， 就 不 会 存在 下 载 延迟 。 

完美 的 预 加 载 虽然 不 容易 做 ,但 对 用 户 来 说 ， 这 会 带 来 截然 不 同 的 使 用 体验 。 作 为 第 二 个 稍 
有 难度 的 练习 ， 请 在 显示 GalleryItem 时 ， 为 前 十 个 和 后 十 个 GatlleryItem 预 加 载 Bitmap。 
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本 章 ,， 我 们 为 PhotoGallery 应 用 添加 搜索 功能 。 




















借 此 学 习 如 何 使 用 SearchView 在 应 用 中 整合 


搜索 功能 。SearchView 是 个 可 以 舰 人 工具 栏 的 操作 视图 类 (action view )。 


点 按 SearchView， 用户 可 以 输入 查询 关键 字 ， 


提交 查询 请 求 搜索 Flickr， 结果 将 显示 在 





RecyclerView 中 ， 如 图 27-1 所 示 。 用 户 提交 过 的 查询 关键 字 会 保存 下 来 。 3 





备 重启 ， 依 然 可 以 找 回 他 们 。 
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27.1 搜索 Flickr 网 站 


图 27-1 ”搜索 界面 
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搜索 Flickr 网 站 需要 调用 flickr.photos.search 方 法 。 以 下 为 搜索 cat 文 本 的 GET 请 求 示 例 : 


https://api.flickr.com/services/rest/?method=flickr.photos.search 
&api key=xxx&format=json&nojsoncallback=l&text=cat 


可 以 看 到 , 搜索 方法 指定 为 fTLickr.photos.se 
的 内 容 就 是 cat 这 样 的 搜索 字符 串 。 





arch。 一 个 text 新 参数 附加 在 请 求 后 面 ， 
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虽然 搜索 URL 和 图 片 下 载 请 求 URL 不 同 ， 但 网 站 返回 的 JSON 数 据 格 式 是 一 样 的 。 这 方便 了 
开发 ， 因 为 不 管 是 搜索 还 是 下 载 图 片 ， 我 们 都 可 以 使 用 同样 的 JSON 数 据 解析 逻辑 。 

首先 , 重 构 FLickrFetchr 代 码 以 复 用 JSON 数 据 解析 逻辑 。 先 添加 一 些 URIL 复 用 相关 的 常量 。 
再 从 fetchItems 方 法 中 剪 切 URI 创 建 代 码 ， 复 制作 为 ENDPOINT 的 值 。 注 意 ， 只 应 使 用 加 亮 部 分 
的 代码 。ENDPOINT 常 量 不 应 包括 查询 方法 参数 ，build 语 句 不 应 使 用 toString() 方 法 。 如 代码 
清单 27-1 所 示 。 


代码 清单 27-1 添加 URL 常 量 (FlickrFetchrjava ) 
public class FlickrFetchr { 
































private static final String TAG = "FlickrFetchr"; 


private static final String API KEY = "yourApiKeyHere"; 

private static final String FETCH RECENTS METHOD = "flickr.photos.getRecent"; 

private static final String SEARCH METHOD = "flickr.photos.search"; 

private static final Uri ENDPOINT = Uri 
.parse("https://api.flickr.com/services/rest/") 


.buildUpon() 
.appendQueryParameter("api key", API_ KEY) 
.appendQueryParameter("format", "json") 
.appendQueryParameter("nojsoncallback", "1") 
.appendQueryParameter("extras", "url_s") 
.build(); 


public List<GalleryItem> fetchItems() { 
List<GalleryItem> items = new ArrayList<>(); 


try { 
String url = Uri.parse("https://api. flickr.com/services/rest/")} 

=buitdupen( 
-appendQueryParameteFr(Cmethoed "flickr.photos.getRecent") 
appendQueryParameter ("api_ key" API_KEY) 
=™appendQueryParameter("format’", “sen 
=appendQueryParameter('"nojsoncaltback”, "1") 
=appendQueryParameter( "extFas" "url_s") 

















huitdO -toStringO 
String jsonString = getUrlString(url); 


} catch (IOException ioe) { 

Log.e(TAG, "Failed to fetch items", ioe); 
} catch (JSONException je) { 

Log.e(TAG, "Failed to parse JSON", je); 
} 


return items; 


} 
( 刚才 的 代码 调整 会 导致 fetchItems() 方 法 出 错 。 没 关系 ,暂时 忽略 , 稍 后 会 重 写 这 个 方法 。) 
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为 了 通用 ， 重 命名 fetchItems () 方 法 为 downLoadGaLLeryItems(String urL) 。 新 方法 也 
不 应 是 公共 的 了 ， 所 以 改 成 私有 方法 ， 如 代码 清单 27-2 所 示 。 


代码 清单 27-2 重 构 Flickr 代 码 (FlickrFetchrjava ) 
public class FlickrFetchr { 


private List<GalleryItem> downloadGalleryItems(String url) { 
List<GalleryItem> items = new ArrayList<>(); 


try { 
String jsonString = getUrlString(url); 
Log.i(TAG, "Received JSON: " + jsonString); 
JSONObject jsonBody = new JSONObject(jsonString); 
parseItems (items, jsonBody); 

} catch (IOException ioe) { 
Log.e(TAG, "Failed to fetch items", ioe); 

} catch (JSONException je) { 
Log.e(TAG, "Failed to parse JSON", je); 

3 


return items; 


} 
downloadGalleryItems (String) 新 方法 使 用 URL 参 数 , 不 用 再 创建 URLT 了 。 所 以 , 在 其 
部 添加 一 个 新 方法 基于 用 户 功 能 ( 搜索 或 下 载 ) 和 查询 值 创建 URL， 如 代码 清单 27-3 所 示 。 


代码 清单 27-3 ”添加 创建 URL 的 辅助 方法 ( FlickrFetchr.java ) 


public class FlickrFetchr { 

















private List<GalleryItem> downloadGalleryItems(String url) { 


} 


private String buiLdUrL(String method, String query) { 
Uri.Builder uriBuilder = ENDPOINT.buildUpon() 
.appendQueryParameter("method", method); 


if (method.equals(SEARCH METHOD)) { 
uriBuilder.appendQueryParameter("text", query); 


} 


return uriBuilder.build().toString(); 
} 


private void parseltems(List<GalleryItem> items, JSONObject jsonBody) 
throws IOException, JSONException { 
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如 同 已 删除 的 fetchItems () 方 法 ，buiLdUrtL( ...) 方 法 会 自动 拼接 必要 的 参数 。 不 过 ， 
数值 是 动态 确定 的 。 如 果 判 断 出 是 搜索 ， 它 就 会 附加 一 个 text 参 数值。 
现在 为 下 载 和 搜索 添加 相应 的 方法 ， 如 代码 清单 27-4 所 示 。 


代码 清单 27-4 ”添加 方法 用 于 下 载 和 搜索 ( FlickrFetchrjava ) 


public class FlickrFetchr { 


Sp 





public String getUrlString(String urlSpec) throws IOException { 
return new String(getUrlBytes(urlSpec)); 
} 


public List<GalleryItem> fetchRecentPhotos() { 
String url = buildUrl(FETCH RECENTS METHOD, nul1); 
return downloadGalleryItems (url); 


} 


public List<GalleryItem> searchPhotos(String query) { 
String url = buildUrl(SEARCH METHOD, query); 
return downloadGalleryItems (url); 


} 


private List<GalleryItem> downloadGalleryItems(String url) { 
List<GalleryItem> items = new ArrayList<>(); 


return items; 


} 
FlickrFetchr 现 在 可 以 处 理 搜索 和 图 片 下载 了 。fetchRecentPhotos() 和 searchPhotos 
(String) 方 法 各 自 担任 从 Flickr 获 取 GalleryItem 的 公共 接口 。 
FlickrFetchr 方 法 中 的 重 构 应 体现 在 fragment 代 码 中 。 在 PhotoGalleryFragment.java 中 ,更 新 
FetchItemsTask 类 代码 。 
代码 清单 27-5 ” 硬 编 码 的 搜索 字符 串 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 











private class FetchItemsTask extends AsyncTask<Void,Void,List<GalleryItem>> { 
@Override 
protected List<GalleryItem> doInBackground(Void,... params) { 


Freturn new FlickrFetchr().fetchItems(}; 
String query = "robot"; // Just for testing 


if (query == nuLL) { 

return new FlickrFetchr().fetchRecentPhotos(); 
} else{ 

return new FlickrFetchr().searchPhotos (query); 


上 
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Goverride 
protected void onPostExecute(List<GalleryItem> items) { 


mItems = items; 
setupAdapter(); 
} 
} 
} 


如 果 搜 索 查询 字符 串 非 空 〈 现在 肯定 非 空 )，FetchItemsTask 就 会 执行 Flickr 搜 索 任务 。 否 
则 ， 就 和 以 前 一 样 ， 默 认 下 载 最 新 公共 图 片 。 

尽管 还 没有 为 用 户 提 供 输 入 查询 的 用 户 界面 , 但 我 们 可 以 使 用 硬 编 码 搜 索 字 符 串 来 测试 搜索 
代码 。 

运行 PhotoGallery 并 查看 返回 结果 。 应 该 可 以 看 到 一 两 张 机 器 人 图 片 ， 如 图 27-2 所 示 。 


WA 7:00 
PhotoGallery 
py 1 
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图 27-2 ” 硬 编 码 搜 索 结 果 


27.2 使 用 SearchView 


既然 FLickrFetchr 已 支持 搜索 , 现在 就 来 用 SearchView 创 建 搜索 界面 让 用 户 输入 查询 关 
键 字 并 触发 搜索 。 

SearchView 是 个 操作 视图 。 所 谓 操作 视图 ， 就 是 可 以 内 置 在 工具 栏 中 的 视图 。SearchView 
可 以 让 整个 搜索 界面 完全 内 置 在 应 用 的 工具 栏 中 。 

首先 ， 确 认 应 用 顶部 有 工具 栏 ( 包含 应 用 名 称 )。 如 果 没 有 ， 请 参照 第 13 章 添加 。 

接 下 来 ， 在 res/menu/fragment photo_gallery.xml 文 件 中 ， 为 PhotoGalleryFragment 创 建 一 
个 新 的 菜单 XML 文件 ， 可 以 通过 这 个 文件 指定 工具 栏 上 要 显示 什么 。 如 代码 清单 27-6 所 示 。 
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代码 清单 27-6 ”添加 菜单 XML 文件 (res/menu/fragment photo gallery.xml ) 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 


<item android:id="@+id/menu item search" 
android:title="@string/search" 
app:actionViewClass="android. support.v7 .widget.SearchView" 
app:showAsAction="ifRoom" /> 


<item android:id="@+id/menu_item clear" 
android:title="@string/clear_search" 
app:showAsAction="never" /> 
</menu> 











| 展 


， 稍 后 会 处 理 。 





新 XML 文件 会 出 现 一 些 错误 ， 因 为 暂时 还 没有 为 android:tittLe 属 性 定义 字符 串 。 忽 略 这 


通过 为 app:actionViewClass 属 性 指定 android.support.v7.widget.SearchView 值 , 代 
码 清 单 27-6 中 的 第 一 个 定义 项 告诉 工具 栏 要 显示 SearchView。( 注意 ，showAsAction 和 
actionViewClass 属 性 都 需要 app 命 名 空间 。 不 清楚 为 什么 这 样 用 的 话 ， 建 议 再 复习 一 下 第 13 章 











内 容 。 ) 


SearchView (android.widget.SearchView ) 最 早 是 在 API11 中 (Honeycomb 3.0 ) 引入 的 。 
不 过 , 现在 它 已 放 入 支持 库 中 (android .support.v7.widget.SearchView )。 那么 到 底 该 用 哪 
个 版 本 呢 ? 相 信 你 已 在 代码 中 看 到 答案 : 使 用 支持 库 版 本 。 是 不 是 有 点 奇怪 ? 毕竟 PhotoGallery 



































应 用 最 低 SDK 版 本 已 经 是 19 了 。 


基于 与 第 7 章 一 样 的 理由 ， 我 们 推荐 使 用 支持 库 版 本 。 随 着 Android 新 版 本 的 发 表 ， 新 功能 
在 不 断 添 加 。 这 些 新 功能 通常 会 加 入 支持 库 中 。 主 题 就 是 这 样 的 一 个 例子 。Lollipop 5.0 ( API21 ) 
发 布 后 ， 原 生 SearchView 有 许多 选项 可 以 定制 SearchView 界 面 风格 。 要 想 在 早期 版 本 Android 






































系统 ( 最 低 到 API7 ) 上 使 用 这 些 新 特性 ， 就 只 能 选择 支持 库 版 SearchView 了 。 
代码 清单 27-6 中 的 第 二 个 定义 项 会 添加 一 个 Clear Search 选 项 。 由 于 app:showAsActio 














n 属 性 











值 设置 为 never， 这 个 选项 就 只 能 出 现在 溢出 菜单 中 。 后 面 ， 我 们 会 配置 它 ， 实 现 点 按 该 选项 就 





删除 已 保存 的 搜索 字符 串 。 所 以 ， 暂 时 先 忽 略 它 。 
现在 来 解决 菜单 XML 中 的 未 定义 字符 串 错误 。 打 开 strings.xml 文 件 ， 添 加 缺失 的 字符 虽 
代码 清单 27-7 所 示 。 


代码 清单 27-7 ”添加 搜索 字符 串 〈Tres/values/strings.xml ) 


«eSources 














<string name="search">Search</string> 
<string name="clear search">Clear Search</string> 


</resources> 








Ud 


， 如 


最 后 ， 在 PhotoGalleryFragment.java 文 件 中 ， 在 onCreate(.. . ) 方 法 中 调用 setHas0ptionsMenu 
(true) 方 法 让 fragment 接 收 菜单 回调 方法 。 然后, 覆盖 onCreate0ptionsMenu(...) 方 法 并 实例 
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化 菜单 XML 文 件 ， 如 代码 清单 27-8 所 示 。 这 样 ， 工 具 栏 就 能 显示 定义 在 菜单 XML 中 的 选项 了 。 


代码 清单 27-8 履 盖 onCreate0ptionsMenu(. ..) 方 法 (PhotoGalleryFragment,java ) 


public class PhotoGalleryFragment extends Fragment { 





@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setRetainInstance(true); 
setHasOptionsMenu (true); 
new FetchItemsTask().execute(); 


} 


@Override 
public void onDestroy() { 


} 


@Override 

public void onCreate0ptionsMenu(Menu menu, MenuInflater menuInflater) { 
super.onCreateOptionsMenu(menu, menuInflater); 
menuInfLater.infLate(R.menu.fragment_photo_gaLLery，menu) ; 


} 





private void setupAdapter() { 


} 


运行 PhotoGallery 看 看 SearchView 的 界面 是 什么 样 的 。 点 击 Search 按 钮 ， 会 出 现 一 个 供用 户 
输入 的 文本 框 ， 如 图 27-3 所 示 。 








入 




















图 27-3 ”搜索 界面 
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SearchView 展 开 后 ， 一 个 x 按钮 会 出 现在 右边 。 点 按 它 会 删除 用 户 输入 文字 。 再 次 点 按 它 ， 
SearchView 就 会 回 到 只 有 一 个 搜索 按钮 的 界面 。 
现在 尝试 提交 搜索 不 会 有 任何 结果 。 不 要 急 ，SearchView 稍 后 就 会 有 响应 。 


响应 用 户 搜索 


用 户 提交 查询 后 ， 应 用 立即 开始 搜索 Flickr 网 站 ， 然 后 刷新 显示 搜索 结果 。 查 阅 开 发 文档 可 
知 ，SearchView.0nQueryTextListener 接 口 已 提供 了 接收 回调 的 方式 ， 可 以 响应 查询 指令 。 

更 新 onCreate0ptionsMenu(...) 方 法 ,添加 一 个 SearchView.0nQueryTextListener 监 
听 方 法 ， 如 代码 清单 27-9 所 示 。 


代码 清单 27-9 日志 记录 Searchview.0nQueryTextListener 事 件 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 





























@Override 

public void onCreate0ptionsMenu(Menu menu, MenuInflater menuInfLater) { 
super.onCreateOptionsMenu(menu, menuInflater); 
menuInflater.inflate(R.menu.fragment photo gallery, menu); 


MenuItem searchItem = menu.findItem(R.id.menu item search); 
final SearchView searchView = (SearchView) searchItem.getActionView(); 


searchView.setOnQueryTextListener(new SearchView.0nQueryTextListener() { 
@Override 
public boolean onQueryTextSubmit(String s) { 
Log.d(TAG, "QueryTextSubmit: " + s); 
updateItems () ; 
return true; 


} 


@Override 

public boolean onQueryTextChange(String s) { 
Log.d(TAG, "QueryTextChange: " + s); 
return false; 


}); 
} 


private void updateItems() { 
new FetchItemsTask().execute(); 


} 
在 onCreate0ptionsMenu(...) 方 法 中 ,我们 首先 从 菜单 中 取出 MenuItem 并 把 它 保存 在 
searchItem 变 量 中 。 然 后 ， GA Lo en ) 方 法 从 这 个 变量 中 取出 SearchView 对 象 。 


取 到 SearchView 对 象 , 就 可 以 使 用 set0nQueryTextListener(,,,) 方 法 设置 SearchView， 
OnQueryTextListener 了 。 另 外 ， 你 还 必须 覆盖 监听 器 接口 实现 里 的 onQueryTextSubmit 
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(String) 和 onQueryTextChange (String) 方 法 。 

只 要 SearchView 文 本 框 里 的 文字 有 变化 ，onQueryTextChange (String) 回 调 方法 就 会 执 
行 。 在 PhotoGallery 应 用 中 ， 这 个 回调 方法 除了 记 日 志 以 外 不 会 干 其 他 任何 事 。 

用 户 提交 搜索 查询 时 ，onQueryTextSubmit(String) 回 调 方 法 就 会 执行 。 用户 提 交 的 搜索 

















字符 串 会 传 给 它 。 搜 索 请 求 受理 后 ， 该 方法 会 返回 true。 这 个 方法 也 是 启动 FetchItemsTask 搜 
索 结 果 的 地 方 。( 现在 FetchItemsTask 里 仍 是 一 个 硬 编 码 的 查询 , 稍 后 会 改 用 用 户 提交 的 查询 请 
求 。) 


updateItems () 方 法 现在 还 没 多 大 用 。 稍 后 ， 会 有 好 几 个 地 方 要 执行 FetchItemsTask。 
updateItems ( ) 就 是 一 个 调用 FetchItemsTask 的 封装 方法 。 

最 后 ， 在 onCreate(...) 方 法 中 ,删除 创建 和 执行 FetchItemsTask 的 那 行 代 码 ， 改 用 
updateItems ( ) 封 装 方法 ， 如 代码 清单 27-10 所 示 。 


代码 清单 27-10 使 用 updateItems ( ) 封 装 方法 ( PhotoGalleryFragment.java ) 
public class PhotoGalleryFragment extends Fragment { 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setRetainInstance(true); 
setHasOptionsMenu(true); 


updateItems () ; 


Log.i(TAG, "Background thread started"); 


} 

运行 应 用 并 提交 搜索 查询 。 可 以 看 到 ,虽然 图 片 重新 加 载 了 ,搜索 结果 仍然 是 基于 代码 清 
27-5 中 的 硬 编码 搜索 字符 串 。 男 外 , 在 日 志 中 可 以 看 出 SearchView.0nQueryTextListener 回 调 
方法 已 成 功 执 行 。 

注意 : 如 果 在 模拟 器 上 使 用 物理 键盘 ( 比如 笔记 本 的 键盘 ) 提交 查询 , 搜索 会 连续 执行 两 次 。 
从 用 户 角度 看 ， 就 是 先 看 到 下 载 的 搜索 结果 ， 然 后 这 些 图 片 又 全 部 重新 加 载 一 次 。 这 
SearchView 的 一 个 bug。 这 个 问题 只 会 出 现在 模拟 器 上 ， 可 以 不 用 管 它 。 
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现在 ,删除 硬 编码 搜索 字符 串 ， 我 们 来 实现 用 户 在 SearchView 中 输入 并 提交 的 查询 指令 。 

在 PhotoGallery 应 用 中 ， 一 次 只 有 一 个 激活 的 查询 。 应 用 应 该 保存 这 个 查询 ， 即 使 应 用 或 设 
备 重 启 也 不 会 丢失 。 要 实现 这 个 目标 ， 可 以 把 查询 字符 串 写 信 shared preferences。 只 要 用 户 提交 
查询 ， 就 把 它 写 人 shared preferences， 履 盖 掉 之 前 记录 的 字符 串 。 实 际 搜索 Flickr 时 ， 就 从 shared 
preferences 中 取出 查询 字符 串 ， 把 它 作 为 text 参 数值 。 
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shared preferences 本 质 上 就 是 文件 系统 中 的 文件 ， 可 使 用 SharedPreferences 类 读 写 它 。 
SharedPreferences 实 例 用 起 来 更 像 一 个 键 值 对 仓库 (类 似 于 Bundte )， 但 它 可 以 通过 持久 化 
存储 保存 数据 。 键 值 对 中 的 键 为 字符 串 ， 而 值 是 原子 数据 类 型 。 进 一 步 查看 shared preferences 
文件 可 知 ,它们 实际 上 是 一 种 简单 的 XML 文件 , 但 SharedPreferences 类 已 屏蔽 了 读 写 文件 的 
实现 细节 。shared preferences 文 件 保存 在 应 用 沙 盒 中 , 所 以 , 不 应 用 它 保存 类 似 密码 这 样 的 敏感 
信息 。 

要 获得 SharedPreferences 定 制 实例 , 可 使 用 Context .getSharedPreferences (String， 
int) 方 法 。 然 而 ， 在 实际 开发 中 ， 我 们 并 不 关心 SharedPreferences 实 例 具体 是 什么 样 ， 只 要 
它 能 共享 于 整个 应 用 就 可 以 了 。 这 种 情况 下 ， 最 好 使 用 PreferenceManager.getDefault- 
SharedPreferences(Context) 方 法 , 该 方法 会 返回 具有 私有 权限 和 默认 名 称 的 实例 ( 仪 在 当前 
应 用 内 可 用 )。 

如 代码 清单 27-11 所 示 , 添加 一 个 名 为 QueryPreferences 的 新 类 , 用 于 读 取 和 写 人 查询 字符 串 。 


代码 清单 27-11 管理 保存 的 查询 字符 串 〈QueryPreferences.java ) 


public class QueryPreferences { 
private static final String PREF_ SEARCH QUERY = "searchQuery"; 



















































































public static String getStoredQuery(Context context) { 
return PreferenceManager.getDefaultSharedPreferences (context) 
.getString(PREF_SEARCH_QUERY, null); 
} 


public static void setStoredQuery(Context context, String query) { 
PreferenceManager.getDefaultSharedPreferences (context) 
.edit() 
.putString(PREF_SEARCH_QUERY, query) 
"apply(); 


} 

PREF_SEARCH_QUERY 用 作 查 询 字符 串 的 存储 key， 读 取 和 写 入 都 要 用 到 它 。 

getStoredQuery(Context ) 方 法 返回 shared preferences 中 保存 的 查询 字符 串 值 。 不 过 ， 它 首 
先 要 找到 指定 context 中 的 默认 SharedPreferences。( QueryPreferences 类 没有 自己 的 
Context， 所 以 该 方法 的 调用 者 必须 传人 一 个 。) 

取出 查询 字符 串 值 非常 简单 ， 调 用 SharedPreferences.getString(...) 就 可 以 了 。 如 果 
是 其 他 类 型 数据 , 就 调用 对 应 的 取 值 方法 , 比如 getInt(...)。SharedPreferences.getString 
(PREF_SEARCH_QUERY, nul1) 方 法 的 第 二 个 参数 指定 默认 返回 值 ， 如 果 找 不 到 PREF_SEARCH_ 
QUERY 对 应 的 值 ， 就 返回 anull 值 。 

setStoredQuery(Context) 方 法 向 指定 context 的 默认 shared preferences 写 人 查询 值 。 在 以 上 
代码 中 ， 调 用 SharedPreferences.edit () 方 法 ， 可 获取 一 个 SharedPreferences .Editor 实 例 。 
它 就 是 在 SharedPreferences 中 保存 查询 信息 要 用 到 的 类 。 与 FragmentTransaction 的 使 用 类 
似 , 利用 SharedPreferences.Editor, 可 将 一 组 数据 操作 放 入 一 个 事务 中 。 如 有 一 批 数据 要 更 
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新 ， 在 一 个 事务 中 批量 写 入 就 可 以 了 。 

完成 所 有 数据 的 变更 准备 后 , 调用 SharedPreferences .Editor 的 apply() 异 步 方 法 写 人 数 
据 。 这样, 该 SsharedPreferences 文 件 的 其 他 用 户 就 能 看 到 写 入 的 数据 了 。apply() 方 法 首先 在 
内 存 中 执行 数据 变更 ， 然 后 在 后 台 线 程 上 真正 把 数据 写 人 文件 。 

QueryPreferences 是 PhotoGallery 应 用 的 数据 存储 引擎 。 既 然 已 经 搞定 了 查询 信息 的 读 取 和 
写 入 方法 ， 现 在 就 在 PhotoGalleryFragment 中 应 用 它们 。 
首先 是 保存 用 户 提交 的 查询 信息 ， 如 代码 清单 27-12 所 示 。 


代码 清单 27-12 存储 用 户 提 交 的 查询 信息 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 




































































@Override 
public void onCreate0ptionsMenu(Menu menu, MenuInflater menuInfLater) { 


searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() { 
@Override 
public boolean onQueryTextSubmit(String s) { 
Log.d(TAG, "QueryTextSubmit: " + Ss); 
QueryPreferences.setStoredQuery(getActivity(), s); 
updateItems (); 
return true; 


J. 





@Override 

public boolean onQueryTextChange(String s) { 
Log.d(TAG, "QueryTextChange: " + s); 
return false; 


}); 


接 下 来 ， 在 用 户 从 溢出 菜单 选择 Clear Search 选 项 时 清除 存储 的 查询 信息 (设置 为 null )， 如 
代码 清单 27-13 所 示 。 





代码 清单 27-13 ”清除 查询 信息 ( PhotoGalleryFragment.java ) 
public class PhotoGalleryFragment extends Fragment { 
@Override 
public void onCreate0ptionsMenu(Menu menu, MenuInflater menuInfLater) { 


} 


@Override 
public boolean on0ptionsItemSeLected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.menu_item clear: 
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QueryPreferences.setStoredQuery (getActivity(), null); 
updateItems () ; 
return true; 
default: 
return super.onOptionsItemSelected(item); 


} 

注意 到 了 没有 ? 和 代码 清单 27-12 中 的 做 法 一 样 ， 更 新 完 查询 信息 ，updateItems ( ) 方 法 会 
被 调用 。 这 很 有 必要 ， 可 以 确保 RecycterView 中 显示 最 新 的 搜索 结 

最 后 , 别 忘 了 更 新 FetchItemsTask， 以 使 用 保存 的 查询 字符 串 (终于 可 以 不 用 硬 编码 字符 串 
了 )。 在 FetchItemsTask 中 添加 一 个 定制 构造 方法 ， 用 于 接收 查询 信息 并 保存 在 一 个 成 员 变 量 
备用 。 更 新 updateItems () 方 法 ， 从 shared preferences 中 取出 保存 的 查询 信息 ， 用 它 创 建 一 个 
FetchItemsTask 新 实例 ， 如 代码 清单 27-14 所 示 。 



































代码 清单 27-14 ”在 FetchItemsTask 中 使 用 保存 的 查询 信息 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 


private void updateItems() { 
String query = QueryPreferences.getStoredQuery(getActivity()); 
new FetchItemsTask(query).execute(); 


} 


private class FetchItemsTask extends AsyncTask<Void,Void,List<GalleryItem>> { 
private String mQuery; 


public FetchItemsTask(String query) { 
mQuery = query; 


} 


@Override 
protected List<GalleryItem> doInBackground(Void... params) { 
String query = "robot"; // Just for testing 





if (querymQuery == null) { 
return new FlickrFetchr().fetchRecentPhotos(); 
} else { 
return new FlickrFetchr().searchPhotos (querymQuery); 
} 
} 


@Override 

protected void onPostExecute(List<GalleryItem> items) { 
mItems = items; 
setupAdapter(); 
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搜索 功能 现在 应 该 能 用 了 。 运 行 PhotoGallery 应 用 ， 尝 试 一 些 搜索 并 查看 返回 结果 。 


27.4 优化 应 用 


本 章 任务 完成 ， 可 以 考虑 做 点 应 用 优化 了 。 如 果 用 户 点 击 搜索 按钮 展开 SearchView 时 ， 搜 
索 文 本 框 能 显示 已 保存 的 查询 字符 串 该 多 好 。 用 户 点 击 搜索 按钮 时 ，SearchView 的 View. 
OnClickListener.onClick() 方 法 会 被 调用 。 利 用 这 个 回调 方法 设置 搜索 文本 框 的 值 ， 如 代码 
清单 27-15 所 示 。 




















代码 清单 27-15 ”默认 显示 已 保存 查询 信息 (PhotoGalleryFragment.java ) 
public class PhotoGalleryFragment extends Fragment { 
@Override 
public void onCreate0ptionsMenu(Menu menu, MenuInflater menuInfLater) { 


searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() { 


}); 


searchView.setOnSearchClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
String query = QueryPreferences.getStoredQuery(getActivity()); 
searchView.setQuery(query, false); 


}); 








运行 应 用 ,尝试 一 些 搜索 。 然 后 ,检验 一 下 刚才 优化 的 成 果 。 应 用 优化 无 法 一 践 而 就 ,关键 
是 要 做 个 有 心 人 。 
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你 可 能 已 经 注意 到 了 ， 提 交 搜 索 时 ，RecyclerView 要 等 好 一 会 才能 刷新 显示 搜索 结果 。 请 
接受 挑战 , 让 搜索 过 程 更 流畅 一 些 。 用 户 一 提交 搜索 ,就 隐藏 软 键盘 , 收 起 SearchView 视 图 ( 回 
到 只 显示 搜索 按钮 的 初始 状态 )。 

再 来 个 挑战 。 用 户 一 提交 搜索 , 就 清空 RecyclerView, 显示 一 个 搜索 结果 加 载 状 态 界面 (使 
用 状态 指示 融 )。 下 载 到 JSON 数 据 之 后 ， 就 删除 状态 指示 絮 。 也 就 是 说 ,一 旦 开始 下 载 图片 ， 就 
不 应 显示 加 载 状 态 了 。 












































后 台 服 务 























目前 为 止 ， 本 书 所 有 的 应 用 都 离 不 开 activity， 也 就 是 说 它们 都 有 一 个 或 多 个 看 得 见 的 用 户 





界面 。 














如 播放 音乐 或 在 RSS feed 上 检查 新 博文 推送 ， 又 该 如 何 做 呢 ? 好 办 ， 使 用 服务 




















如 果 不 给 应 用 提供 用 户 界 面 ， 应 该 怎样 做 呢 ” 如 果 不 用 看 、 不 用 操作 ， 只 想 任务 在 后 台 运 行 ， 


( service )。 





本 章 ， 我 们 为 PhotoGallery 应 用 再 添 一 项 功能 ， 人 允许 其 在 后 台 下 载 新 的 搜索 结果 。 一 旦 有 了 








新 结果 ， 用 户 就 能 在 状态 栏 看 到 到 通知 消息 。 


28.1 创建 IntentService 





首先 使 用 IntentService 创 建 服务 。IntentService 并 不 是 Android 唯 一 可 用 的 服务 ， 但 应 











该 是 最 常用 的 。 创 建 一 个 名 为 PoLLService 的 IntentService 子 类 , 它 就 是 月 





服务 。 


代码 清单 28-1 创建 PollService (PollService.java) 


public class PollService extends IntentService { 
private static final String TAG = "PollService"; 


public static Intent newIntent(Context context) { 
return new Intent(context, PollService.class); 


} 


public PollService() { 
super (TAG); 
} 


@Override 
protected void onHandleIntent(Intent intent) { 
Log.i(TAG, "Received an intent: " + intent); 
} 
} 


来 轮 询 搜索 结果 的 


上 述 代码 实现 了 最 基本 的 IntentService。 它 能 做 什么 呢 ?” 实 际 上 , 它 和 activity 有 点 像 。 它 





是 一 个 context ( Service 是 Context 的 子 类 ), 能 够 响应 intent ( 看 onHandLeIntent(Intent ) 方 法 就 
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知道 )。 好 的 规范 要 遵守 ， 所 以 ， 我 们 添加 一 个 newIntent (Context) 方 法 。 无 论 谁 想 启动 这 个 





服务 ， 都 应 使 用 它 。 








服务 的 intent 又 叫 命 令 〈command )。 所 谓 命 令 ， 就 是 要 服务 做 事 的 一 条 指令 。 服 务 的 种 类 不 


同 ， 其 执行 命令 的 方式 也 不 尽 相 同 。 





IntentService 服 务 能 顺序 执行 命令 队列 里 的 命令 ， 如 图 28-1 所 示 。 


1. 收 到 1 号 Intent 命 令 
服务 创建 完毕 





命令 队列 







IntentService 


onHandlelntent(Intent #1) 


3. 收 到 3 号 Intent 命 令 







命令 队列 


IntentService 


onHandlelntent(Intent #1) 


5.2 号 Intent 命 令 执行 完毕 


命令 队列 






IntentService 


onHandlelntent(Intent #3) 





2. 收 到 2 号 Intent 命 令 


命令 队列 





IntentService 


onHandlelntent(Intent #1) 


4. 1 号 Intent 命 令 执 行 完毕 


命令 队列 





IntentService 


onHandlelntent(lIntent #2) 


6. 3 号 Intent 命 令 执行 完毕 


服务 销毁 


图 28-1 IntentService 执 行 命令 的 方式 


收 到 第 一 条 命令 时 ，IntentService 启 动 ， 触 发 一 个 后 台 线程 ， 然 后 将 命令 放 入 一 个 队列 。 








随后 ，IntentService 按 顺序 执行 每 一 条 命令 ， 并 针对 每 一 条 命令 在 后 台 线 程 上 调用 
onHandleIntent (Intent) 方 法 。 新 进 命 令 总 是 放置 在 队 尾 。 最 后 , 执行 完 队列 中 的 全 部 命令 后 ， 
服务 也 随即 停止 并 被 销毁 。 

以 上 描述 仅 适 用 于 IntentService。 本 章 稍 后 会 介绍 更 多 服务 以 及 它们 执行 命令 的 方式 。 

既然 类 似 于 activity， 能 够 响应 intent， 就 必须 在 AndroidManifestxml 中 声明 它 。 因 此 ， 添 加 一 
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个 PollService 元 素 节 点 定义 ， 如 代码 清单 28-2 所 示 。 


代码 清单 28-2 ”在 manifest 配 置 文 件 中 添加 服务 ( AndroidManifest.xml ) 


<manifest 
xmlns:android="http://schemas.android.com/apk/res/android" 


package="com.bignerdranch.android.photogallery" > 


<uses-permission android:name="android.permission.INTERNET" /> 


<application 
er 
<activity 
android:name=" .PhotoGalleryActivity" 
android:label="@string/app _ name" > 


</activity> 
<service android:name=".PollService" /> 
</application> 
</manifest> 


然后 ， 在 PhotoGalleryFragment 中 ， 添 加 服务 启动 代码 ， 如 代码 清单 28-3 所 示 。 
代码 清单 28-3 ”添加 服务 启动 代码 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 





private static final String TAG = "PhotoGalleryFragment"; 
@Override 
public void onCreate(Bundle savedInstanceState) { 


UpdateItems () ; 


Intent i = PollService.newIntent(getActivity()); 
getActivity().startService(i); 


Handler responseHandler = new Handler(); 
mThumbnailDownloader = new ThumbnailDownloader<>(responseHandler); 


} 
运行 应 用 ， 查 看 LogCat 和 窗口 ， 可 看 到 以 下 类 似 结果 。 


02-23 14:25:32.450 2692-2717/com.bignerdranch.android.photogallery I/PollService: 
Received an intent: Intent { cmp=com.bignerdranch.android.photogallery/.PollService } 


28.2 ”服务 的 作用 


查看 LogCat 日 志 是 不 是 很 乏味 ? 确实 ! 但 刚 添加 的 代码 着 实 令 人 兴奋 ! 为 什么 ? 利用 它 可 以 
完成 什么 ? 
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再 次 回 到 之 前 的 假想 之 地 ， 在 那里 ， 不 做 开发 者 ， 我 们 是 与 内 电 侠 一 起 工作 的 鞋 店 工作 人 员 。 
鞋 店内 有 两 个 地 方 : 与 客户 打交道 的 前 台 ， 以 及 不 与 客户 接触 的 后 台 。 

目前 为 止 ， 所 有 应 用 代码 都 在 activity 中 运行 。activity 就 是 Android 应 用 的 前 台 。 所 有 应 用 代 
码 都 专注 于 提供 良好 的 用 户 视觉 体验 。 

服务 就 是 Android 应 用 的 后 台 。 用 户 不 关心 后 台 发 生 的 一 切 。 即 使 前 台 关 闭 ，activity 消 失 好 
久 了 ， 后 台 服 务 依然 能 持续 工作 。 

好 了 , 鞋 店 的 假想 可 以 告 一 段落 了 。 有 服务 可 以 做 到 而 activity 做 不 到 的 事情 吗 ?” 有 ! 用 户 离 
开 当 前 应 用 后 〈 打 开 其 他 应 用 或 退回 主屏 幕 )， 服 务 依然 可 以 在 后 台 运 行 。 


后 台 网 络 连 接 安全 


服务 会 在 后 台 轮 询 Flickr 网 站 。 为 保证 后 台 网 络 连接 的 安全 性 ， 我 们 需 进 一 步 完 善 代码 。 

Android 有 关闭 后 台 应 用 网 络 连接 的 功能 。 如 果 应 用 非常 耗 电 ， 关 掉 它 们 就 能 延长 续航 时 间 。 
然而 ,这 也 意味 着 在 后 台 连 接 网 络 时 , 需 使 用 ConnectivityManager 确 认 网 络 连 接 是 否 可 用 。 
参照 代码 清单 28-4 添 加 相应 的 检查 代码 。 


代码 清单 28-4 ”检查 后 台 网 络 的 可 用 性 ( PollService.java ) 


public class PollService extends IntentService { 
private static final String TAG = "PollService"; 




































































@Override 
protected void onHandleIntent(Intent intent) { 
if (!isNetworkAvailableAndConnected()) { 
return; 


} 


Log.i(TAG, "Received an intent: " + intent); 


} 


private boolean isNetworkAvailableAndConnected() { 
ConnectivityManager cm = 
(ConnectivityManager) getSystemService(CONNECTIVITY SERVICE); 


boolean isNetworkAvailable = cm.getActiveNetworkInfo() != null; 
boolean isNetworkConnected = isNetworkAvailable && 
cm.getActiveNetworkInfo().isConnected(); 


return isNetworkConnected; 
} 
} 


检查 网 络 是 否 可 用 的 逻辑 在 isNetworkAvaitabLeAndConnected () 方 法 中 。 使 用 后 台数 据 设 
置 选项 关闭 后 台数 据 下 载 后 ,所 有 后 台 服 务 也 就 无 法 联网 了 。 上 述 代码 中 , ConnectivityManager. 
getActiveNetworkInfo() 会 返回 null 值 ， 这 等 于 告诉 后 台 服 务 ， 网 络 不 可 用 ， 哪 怕 实 际 可 以 。 

如 果 后 台 服 务 能 够 使 用 网 络 ， 它 会 得 到 一 个 代表 当前 网 络 连接 的 android .net.NetworkInfo 
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实例 。 然 后 还 要 调用 NetworkInfo.isConnected() 方 法 检查 当前 网 络 是 否 已 连接 。 

如 果 应 用 找 不 到 可 用 网 络 ， 或 者 设备 没有 连 上 网 ，onHandleIntent(...) 方 法 就 会 直接 返回 
(不 会 尝试 去 下 载 数据 了 , 如 果 这 个 方法 添加 了 数据 下 载 代码 的 话 ), 这 个 做 法 不 错 : 网 都 连 不 上 ， 
还 谈 什么 数据 下 载 。 

不 要 忘 了 ， 要 使 用 getActiveNetworkInfo() 方 法 ， 还 要 在 manifest 配 置 文件 中 获取 
ACCESS_NETWORK_STATE 权 限 ， 如 代码 清单 28-5 所 示 。 


代码 清单 28-5 ”获取 网 络 状态 权限 ( AndroidManifest.xml ) 


<manifest 
xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.bignerdranch.android.photogallery" > 























<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 


<application 
二 


</application> 


</manifest> 


28.3 ”查找 最 新 返回 结果 


后 台 服 务 会 一 直 查 看 最 新 返回 结果 ， 因 此 它 要 知道 最 近 一 次 的 获取 结果 。 使 用 Shared- 
Preferences 保 存 结果 值 再 合适 不 过 了 。 
更 新 QueryPreferences 以 存储 最 近 一 次 获取 图 片 的 ID ， 如 代码 清单 28-6 所 示 。 


代码 清单 28-6 ”添加 存储 图 片 卫 的 preference 常 量 (QueryPreferences .java ) 


public class QueryPreferences { 
private static final String PREF SEARCH QUERY = "searchQuery"; 
private static final String PREF_LAST RESULT _ ID = "lastResultId"; 














public static String getStoredQuery(Context context) { 


} 

public static void setStoredQuery(Context context, String query) { 
Se 

public static String getLastResultId(Context context) { 


return PreferenceManager.getDefaultSharedPreferences (context) 
.getString(PREF_LAST_ RESULT_ID, null); 
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public static void setLastResuLtId(Context context, String LastResuLtId) { 
PreferenceManager.getDefaultSharedPreferences(context) 
.edit() 
.putString(PREF_LAST_RESULT_ID, lastResultId) 
apply(); 


} 

接 下 来 就 是 完善 服务 代码 了 。 以 下 是 需要 处 理 的 任务 。 

(1) 从 默认 SharedPreferences 中 获取 当前 查询 结果 以 及 上 一 次 结果 ID。 

(2) 使 用 FLickrFetchr 类 获取 最 新 结果 集 。 

(3) 如 果 有 结果 返回 ， 抓 取 第 一 条 结果 。 

(4) 确认 是 否 不 同 于 上 一 次 结果 人 D。 

(5) 将 第 一 条 结果 存 人 SharedPreferences。 

回 到 PollService.java 中 ， 添 加 实现 代码 。 代 码 清 单 28-7 中 的 代码 虽 长 ， 但 相信 你 已 经 很 熟悉 
了 ， 这 里 不 再 袭 述 。 


代码 清单 28-7 检查 最 新 返回 结果 ( PollService.java ) 


public class PollService extends IntentService { 
private static final String TAG = "PollService"; 


















































ttt 















































@Override 
protected void onHandleIntent(Intent intent) { 


Log.i(TAG, "Received an intent: " + intent); 

String query = QueryPreferences.getStoredQuery (this); 

String LastResuLtId = QueryPreferences.getLastResultId(this); 
List<GalleryItem> items; 








if (query == nuLL) { 

items = new FLickrFetchr().fetchRecentPhotos () ; 
} else{ 

items = new FlickrFetchr().searchPhotos (query); 


} 

if (items.size() == 0) { 
return; 

} 


String resuLtId = items.get(0).getId(); 
if (resultId.equals(lastResultId)) { 

Log.i(TAG, "Got an old result: " + resultId); 
} else{ 

Log.i(TAG, "Got a new result: " + resuLtId) ; 
} 


QueryPreferences.setLastResultId(this, resultId); 
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运行 PhotoGallery 应 用 ， 可 看 到 应 用 首先 获取 了 最 新 结果 。 如 选择 上 一 次 的 搜索 查询 ， 提 交 
搜索 后 ， 很 可 能 会 看 到 和 上 次 同样 的 结果 。 























28.4 使 用 ALarmManager 延迟 运行 服务 


在 没有 activity 运 行 的 情况 下 ， 为 在 后 台 运 行 服务 ， 得 想 个 办 法 启动 它 。 比 如 说 ， 设 置 一 个 5 
分 钟 间隔 的 定时 器 。 
一 种 方式 是 调用 Handler 的 sendMessageDelayed(...,) 或 postDelayed(...) 方 法 。 但 
如 果 用 户 离 开 当 前 应 用 ， 进 程 就 会 停止 ，Handler 消 息 也 会 随 之 消亡 ， 因此 这 个 方案 并 不 可 靠 。 
Handler 不 行 , 我 们 还 可 以 用 AlarmManager。AlarmManager 是 可 以 发 送 Intent 的 系统 服务 。 
如 何 告诉 ALarmManager 我 想 发 的 intent 呢 ? 使 用 PendingIntent。 使 用 PendingIntent 打 包 一 
个 intent:“ 我 想 启动 PollService 服 务 。” 然 后 , 将 其 发 送 给 系统 中 的 其 他 部 件 ， 如 AlarmManager。 
在 PoLLService 类 中 , 实现 一 个 启 停 定 时 需 的 setServiceALarm(Context,bootean) 方 法 ， 
该 方法 是 个 静态 方法 。 这 样 ， 定 时 器 代码 和 与 之 相关 的 代码 就 可 以 放 在 一 起 了 ， 同 时 ， 其 他 系统 
部 件 还 可 以 调用 到 它 。 要 知道 ， 定 时 器 通常 是 从 前 端的 fragment 或 其 他 控制 层 代 码 中 启 停 的 。 如 
代码 清单 28-8 所 示 。 


代码 清单 28-8 ”添加 定时 方法 (PollService.java ) 


public class PollService extends IntentService { 
private static final String TAG = "PollService",; 













































































// Set interval to 1 minute 
private static finaL long POLL_ INTERVAL MS = TimeUnit.MINUTES.toMillis(1); 


public static Intent newIntent(Context context) { 
return new Intent(context, PollService.class); 


} 


public static void setServiceALarm(Context context, boolean is0n) { 
Intent i = PollService.newIntent(context); 
PendingIntent pi = PendingIntent.getService(context, 0, i, 0); 


AlarmManager alarmManager = (AlarmManager) 
context .getSystemService(Context.ALARM SERVICE); 


if (isOn) { 
alarmManager .setRepeating(AlarmManager .ELAPSED REALTIME, 
SystemClock.elapsedRealtime(),POLL INTERVAL MS, pi); 
} else { 
alarmManager .cancel (pi); 
pi.cancel(); 
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以 上 代码 中 ， 首 先是 调用 PendingIntent.getService(,.,) 方 法 ， 创 建 一 个 用 来 启动 
PollService 的 PendingIntent。PendingIntent. i .) 方 法 打包 了 一 个 Context. 
startService(Intent) 方 法 的 调用 。 它 有 四 个 参数 : ey 一 个 区 分 
PendingIntent 来 源 的 请 求 代 码 ， 一 个 待 发 送 的 Intent 对 象 以 及 一 组 用 来 决定 如 何 创 建 
PendingIntent 的 标志 符 。( 稍 后 会 使 用 其 中 的 一 

接 下 来 ， 需 要 设置 或 取消 定时 器 。 

设置 定时 器 可 调用 ALarmManager， setRepeating(...) 方 法 。 该 方法 同样 具有 四 个 参数 : 

一 个 描述 定时 器 时 间 基 准 的 常量 ( 稍 后 详 述 )， | 定时 需 循 环 的 时 间 间 隔 以 及 
一 个 到 时 要 发 送 的 PendingIntent。 

ALarmManager.ELAPSED REALTIME 是 基准 时 间 值 ， 这 表明 我 们 是 以 SystemCLock. 
elapsedRealtime() 走 过 的 时 间 来 确定 何 时 启动 时 间 的 。 也 就 是 说 , 经 过 一 段 指 定 的 时 间 ， 就 启 
动 定 时 器 。 rd 启动 基准 时 间 就 是 当前 时 刻 ( 例如 ，Systenm. 
currentTimeMillis() )。 也 就 是 说 ,一 旦 到 了 某 个 固定 时 刻 ， 就 启动 定时 器 

en canceL(PendingIntent) 方 法 。 通 常 ， 也 需 同 步 取消 
PendingIntent。 稍 后 ， 你 会 看 到 取消 PendingIntent 也 有 助 于 跟踪 定时 器 状态 。 

添加 一 些 快速 测试 代码 ， 从 PhotoGatteryFragment 中 启动 PoLLService 服 务 ， 如 代码 清单 
28-9 所 示 。 


代码 清单 28-9 ”添加 定时 器 启动 代码 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
private static final String TAG = "PhotoGalleryFragment"; 

































































@Override 
public void onCreate(Bundle savedInstanceState) { 


updateItems(); 
I i ~ polls 、 I ( Activity()); 
PollService.setServiceAlarm(getActivity(), true); 


Handler responseHandler = new Handler(); 
mThumbnailDownloader = new ThumbnailDownloader<>(responseHandler); 

















} 
完成 以 上 代码 添加 后 ， 运 行 PhotoGallery 应 用 。 然 后 ， 立 即 点 击 后 退 键 退出 应 用 。 
注意 观察 LogCat 日 志和 窗口 。 可 看 到 PollService 服 务 运行 了 一 次 , 随后 以 60 秒 为 间隔 再 次 运 











行 。 这 正 是 ALarmManager 擅 长 的 事情 。 即 使 进程 停止 了 ，ALarmManager 依 然 会 不 断 发 送 intent， 
反复 启动 PoLLService 服 务 。( 这 种 后 台 服 务 行为 有 时 非常 信人 。 要 彻底 清除 它 ， 可 能 需要 仓 载 
应 用 。) 
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28.4.1 合理 控制 服务 启动 的 频 度 


后 台 重 复 性 工作 的 频 度 需要 十 分 精确 吗 ? 后 台 服 务 重复 性 的 工作 会 消耗 电池 电量 和 数据 流 
量 。 而 且 ， 局 动 服务 还 要 唤醒 设备 ， 这 也 是 个 开销 极 大 的 操作 。 好 在 这 些 都 可 以 控制 。 我 们 可 以 
采取 措施 合理 配置 定时 器 的 启 停 。 比 如 ， 确 定 合 理 的 时 间 间 隔 ， 设 置 唤醒 条 件 等 。 

1. 非 精 准 重复 

setRepeating(...) 方 法 可 以 设置 一 个 重复 定时 器 , 但 不 是 太 精准 。 换 句 话说， 间隔 时 间 可 
能 长 一 些 ， 也 可 能 短 一 些 ， 具 体 Android 说 了 算 。 一 般 来 说 ，60 秒 是 目前 主流 设备 支持 的 最 短 时 
间 (其 他 旧 设 备 支 持 调 长 一 些 )。 

为 啥 这 样 控制 呢 ? 因为 定时 器 会 给 手机 电源 管理 带 来 麻烦 。 每 次 定时 器 一 启动 ,就 会 唤醒 设 
备 ， 启 动 某 个 应 用 。 类 似 PhotoGallery， 许 多 应 用 也 需要 使 用 网 络 ， 这 就 更 耗 电 了 。 

如 果 只 有 你 一 个 应 用 ,定时 器 准 不 准 无 所 谓 。 即 使 定时 器 每 隔 15 分 钟 就 唤醒 设备 ,那么 由 于 
只 有 一 个 这 样 的 定时 器 且 不 精准 ， 一 个 小 时 只 需 唤 醒 设 备 4 次 。 

如 果 有 你 一 个 再 加 上 九 个 其 他 应 用 , 每 个 都 有 一 个 15 分 钟 间隔 的 精准 定时 器 , 情况 就 完全 不 
同 了 。 因 为 每 一 个 定时 都 非常 精准 ， 都 需要 唤醒 设备 ， 每 小 时 唤醒 次 数 就 直接 变 为 恐怖 的 40 次 。 

上 面 说 过 ， 不 精准 就 意味 着 Android 可 以 调整 定时 器 的 启动 时 间 ， 这 样 ， 定 时 器 就 不 用 非常 
精准 地 每 隔 15 分 钟 启 动 了 。 结 果 , 设备 唤醒 后 就 可 以 同时 运行 这 些 定时 吕 ， 每 小 时 唤醒 次 数 又 得 
以 降 至 4 次 。40 次 到 4 次 ， 显 然 要 省 太 多 电 了 。 

当然 ， 有 些 应 用 就 是 需要 精确 定时 器 。 既 然 避 免不了 ， 那 就 必须 用 到 ALarmManager , 
setWindow(,..) 或 AlarmManager.setExact(...) 方 法 。 这 两 个 方法 都 能 设置 定时 器 精准 地 启 
动 一 次 。 如 果 需 要 重复 ， 那 就 只 能 自己 动 动手 了 。 

2. 时 间 基 准 选择 

另 一 个 要 考虑 的 因素 是 时 间 基 准 值 。Android 提 供 了 两 个 选择 : ALarmManager.ELAPSED 
REALTIME 和 ALarmManager .RTC。 

ALarmManager,ELAPSED_REALTIME 使 用 自 最 近 一 次 设备 重启 〈 包 括 睡眠 时 间 ) 开始 走 过 的 
时 间 量 作为 间隔 计算 基准 。 既 然 是 基于 流逝 的 相对 时 间 ， 并且 不 依赖 于 时 钟 时 间 ， 
ELAPSED_REALTIME 就 成 了 PhotoGallery 应 用 定时 器 的 最 佳 选择 。( 查阅 开发 者 文档 可 知 ,Android 
也 首 推 使 用 ELAPSED REALTIME。 ) 

ALarmManager.RTC 使 用 UTC 时 间 。 然 而 ，UTC 没 有 考虑 本 地 时 间 ， 而 用 户 认 为 自己 使 用 的 
时 钟 肯定 已 考虑 了 本 地 时 间 因 素 。 所 以 , 使 用 RTC 作 为 定时 器 时 间 基 准 同样 也 要 考虑 本 地 时 间 因 
素 。 如 果 你 想 设置 一 个 自然 时 间 的 定时 器 ,就 得 自己 处 理 本 地 时 间 和 RTC 基 准时 间 的 换算 。 嫌 麻 
烦 ， 那 就 干脆 使 用 ELAPSED REALTIME。 

无 论 使 用 哪个 时 间 基 准 值 ， 如 果 设 备 处 于 睡眠 模式 ( 黑屏 状态 )， 即 使 时 间 已 过 ， 定 时 器 也 
不 会 触发 。 如 果 想 避免 这 个 问题 ， 可 使 用 与 已 选 基 准时 间 对 应 的 AlarmManager.ELAPSED_ 
REALTIME_WAKEUP 或 ALarmManager.RTC_WAKEUP 常 量 ， 让 定时 器 强制 唤醒 设备 。 然 而 ， 出 于 节 
能 考虑 ， 应 避免 使 用 唤醒 选项 ， 除 非 需 要 绝对 可 靠 的 定时 器 任务 。 






























































































































































































































































28.4 使 用 AlarmManager 延迟 运行 服务 ”461 





28.4.2 PendingIntent 
现在 来 进一步 了 解 前 面 提 及 的 PendingIntent。pPendingIntent 是 一 种 token 对 象 。 调 用 





PendingIntent.getServicel. a MPendangin ent 你 告诉 操作 系统 :“ 请 记 住 ， 
i 。 方法 发 送 这 个 intent。” 随 后 ， 调 用 PendingIntent 对 象 的 
send() 方 法 时 ， 操 作 系 统 照 要 求 发 送 原来 封装 的 intent。 


























es i 将 PendingIntent token 交 给 其 他 应 用 使 用 时 ， 它 是 
代表 当前 应 用 发 送 token 对 象 的 。 另 外 ，PendingIntent 本 身 存在 于 操作 系统 而 不 是 token 里 ， 因 
此 实际 上 是 你 在 控制 着 它 。 如 果 不 顾 及 别人 感受 的 话 , 可 以 在 交 给 别人 一 个 PendingIntent 对 象 
后 ， 立 即 撤销 它 ， 让 send ( ) 方 法 什么 也 做 不 了 。 

如 果 使 用 同一 个 intent 请 求 PendingIntent 两 次 ， 得 到 的 PendingIntent 仍 会 是 同一 个 。 你 
可 借 此 测试 某 个 PendingIntent 是 否 已 存在 ， nnd 













































































28.4.3 ”使 用 PendingIntent 管理 定时 器 


一 个 PendingIntent 只 能 登记 一 个 定时 器 。 这 也 是 is0n 值 为 faLse 时 ，setServiceALarm 
(Context，boolean) 方 法 的 工作 原理 : 首先 调用 ALarmManager.canceL(PendingIntent ) 方 
法 撤销 PendingIntent 的 定时 器 ， 然 后 撤销 PendingIntent。 

既然 撤销 定时 器 也 随即 撤消 了 PendingIntent , 可 通过 检查 PendingIntent 是 否 存在 来 确认 
定时 器 激活 与 否 。 具 体 代 码 实 现时 ， 传 人 PendingIntent ,FLAG_N0O_CREATE 标 志 给 Pending- 
Intent .getService(...) 方 法 即 可 。 该 标志 表示 如 果 PendingIntent 不 存在 , 则 返回 nuLL， 而 
不 是 创建 它 。 

添加 一 个 名 为 isServiceALarm0n(Context) 的 新 方法 ， 并 传人 PendingIntent .FLAG NO_ 
CREATE 标 志 ， 以 判断 定时 器 的 启 停 状 态 ， 如 代码 清单 28-10 所 示 。 


代码 清单 28-10 ”添加 isServiceAlarm0n() 方 法 (PollService.java ) 


public class PollService extends IntentService { 





















































public static void setServiceAlarm(Context context, boolean ison) { 
} 


public static boolean isServiceAlarmOn(Context context) { 
Intent i = PollService.newIntent(context); 
PendingIntent pi = PendingIntent 
.getService(context, 0, i, PendingIntent.FLAG NO_CREATE); 
return pi != null; 





这 里 的 PendingIntent 仅 用 于 设置 定时 器 ， 因 此 PendingIntent 空 值 表示 定时 器 还 未 设置 。 
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28.5 ”控制 定时 器 


既然 可 以 开关 定时 器 ( 也 能 判定 其 启 停 状态 )， 接 下 来 就 实现 在 图 形 界面 里 控制 其 开关 。 首 
先 添加 另 一 菜单 项 到 menu/fragment photo_ gallery.xml， 如 代码 清单 28-11 所 示 。 











代码 清单 28-11 添加 服务 开关 ( menu/fragment photo_gallery.xml ) 
<menu xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:app="http://schemas.android.com/apk/res-auto"> 


<item android:id="@+id/menu item search" 
rr 


<item android:id="@+id/menu item clear" 
Rs 


<item android:id="@+id/menu_item toggle polling" 
android:title="@string/start_ polling" 
app:showAsAction="ifRoom" /> 
</menu> 


然后 添加 一 些 字符 串 资 源 ， 一 个 用 于 启动 polling， 一 个 用 于 停止 polling， 如 代码 清单 28-12 所 
示 。( 后 续 还 需要 其 他 一 些 字符 串 资 源 , 如 显示 在 状态 栏 的 通知 信息 , 因此 现在 也 一 并 完成 添加 。) 


代码 清单 28-12 ”添加 polling 字 符 串 资源 (res/values/strings.xml ) 


ESOUrces> 























<string name="search">Search</string> 

<string name="clear search">Clear Search</string> 

<string name="start_ polling">Start polling</string> 

<string name="stop_polling">Stop polling</string> 

<string name="new pictures title">New PhotoGallery Pictures</string> 

<string name="new pictures_ text">You have new pictures in PhotoGallery.</string> 


</resources> 
删除 前 面 用 于 启动 定时 器 的 测试 代码 ， 添 加 菜单 项 实现 代码 ， 如 代码 清单 28-13 所 示 。 


代码 清单 28-13 ”菜单 项 切换 实现 ( PhotoGalleryFragment.java ) 
private static final String TAG = "PhotoGalleryFragment"; 











@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
updateItems(); 
polls S iceAl ( Activity 人 ); 


Handler responseHandler = new Handler(); 





} 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.menu item clear: 
QueryPreferences.setStoredQuery(getActivity(), null); 
UpdateItems ( ) ; 
return true; 
case R.id.menu item toggle polling: 
boolean shouldStartAlarm = !PollService.isServiceAlarmOn(getActivity()); 
PollService.setServiceAlarm(getActivity(), shouldStartAlarm); 
return true; 
default: 
return super.onOptionsItemSelected(item); 


} 
现在 ， 应 该 可 以 局 停 定时 器 了 。 然 而 ， 你 可 能 已 经 注意 到 ， 即 使 定时 党 已 经 启动 了 ，polling 
选项 菜单 也 总 是 显示 着 Startpolling。 你 0 < 单 标题 , 以 便 和 定时 器 启 停 状 态 匹 配 。( 类 
似 第 13 章 CriminalIntent 应 用 的 SHOW SUBTITLE 控 制 。) 
在 onCreate0ptionsMenu(...) 方 法 中 ， 检 查 定 时 圳 的 开关 状态 ， 然 后 相应 地 更 新 
REteii Eggte potting 的 标题 文字 ， 反馈 正确 的 信息 给 用 户 ， 如 代码 清单 28-14 所 示 。 


























代码 清单 28-14 ”菜单 项 切换 ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends Fragment { 
private static final String TAG = "PhotoGalleryFragment"; 


@Override 
public void onCreate0ptionsMenu(Menu menu, MenuInflater menuInfLater) { 


Super.onCreate0ptionsMenu(menu，menuInfLater) ， 
menuInflater.inflate(R.menu.fragment photo gallery, menu); 


MenuItem searchItem = menu.findItem(R.id.menu item search); 
final SearchView searchView = (SearchView) searchItem.getActionView(); 


searchView.setOnQueryTextListener(...); 
searchView.setOnSearchClickListener(...); 


MenuItem toggleItem = menu.findItem(R.id.menuyu_item toggle polling); 
if (PollService.isServiceAlarmOn(getActivity())) { 
toggleItem.setTitle(R.string.stop_polling); 
} elLse { 
toggLeItem,.setTitLe(R.string,start_poLLing) ; 
} 


} 
接着 , 在 on0ptionsItemSelected(MenuItem) 方 法 中 , 让 PhotoGaLLeryActivity 刷 新 工具 
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栏 选 项 菜单 ， 如 代码 清单 28-15 所 示 。 


代码 清单 28-15 ”让 选项 菜单 失效 ( PhotoGalleryFragment.java ) 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.menu item clear: 


case R.id.menu item toggle polling: 
boolean shouldStartAlarm = !PollService.isServiceAlarmOn(getActivity()); 
PollService.setServiceAlarm(getActivity(), shouldStartAlarm); 
getActivity().invalidateOptionsMenu(); 
return true; 

default: 
return super.onOptionsItemSelected(item); 


} 
现在 ， 选 项 菜单 切换 应 该 可 用 了 。 不 过 ， 后 人 台 服 务 要 真正 有 用 ， 还 有 一 个 地 方 要 完善 


28.6 ”通知 信息 


服务 已 在 后 台 运 行 并 执行 指定 任务 。 不 过 用 户 对 此 毫 不 知情 ， 因 此 作用 有 限 。 

如 果 服 务 需 要 与 用 户 沟通 ， 通 知 信息 ( notification ) 会 是 个 不 错 的 选择 。 通 知 信息 是 指 显示 
在 通知 抽 居 上 的 消息 条 目 ， 用 户 可 向 下 滑动 它 读 取 。 

想 要 发 送 通知 信息 ， 首 先 要 创建 Notification 对 象 。 类 似 第 12 章 的 ALertDiatLog ， 
Notification 需 使 用 构造 对 象 来 创建 。 完 整 的 Notification 至 少 应 包括 以 下 内 容 。 
口 在 Lollipop 之 前 的 设备 上 ， 首 次 显示 通知 信息 时 ， 在 状态 栏 上 显示 的 ticker text ( Lollipop 
之 后 ，ticker text 不 再 显示 在 状态 栏 上 ， 但 仍 与 可 访问 性 服务 相关 )。 
口 在 状态 栏 上 显示 的 图 标 ( 在 Lollipop 之 前 的 设备 上 ， 图 标 在 ticker text 消 失 后 出 现 )。 
口 代表 通知 信息 自身 ， 是 在 通知 抽 居 中 显示 的 一 个 视图 。 
口 待 触发 的 PendingIntent， 用 户 点 击 抽 居 中 的 通知 信息 时 触发 。 

完成 Notification 对 象 的 创建 后 ， 可 调用 NotificationManager 系 统 服务 的 notify(int， 
Notification) 方 法 发 送 它 。 

首先 是 基础 代码 准备 。 在 PhotoGalleryActivityjava 中 ， 添 加 一 个 newIntent ( . . . ) 静态 方法 ， 
如 代码 清单 28-16 所 示 。 该 静态 方法 会 反而 一 外 可 用 及 店 动 i5ED6SLTER AGE 的 Intei 广 这 
例 。( 最 后 ，PoLLService 会 调用 这 个 方法 ， 把 返回 结果 封装 在 一 个 PendingIntent 中 ， 然 后 设 
置 给 通知 消息 。) 


代码 清单 28-16 ”添加 newIntent ( . . . ) 静 态 方法 (PhotoGalleryActivityjava ) 
public class PhotoGalleryActivity extends SingLeFragmentActivity { 


















































































































































public static Intent newIntent(Context context) { 





return new Intent(context, PhotoGalleryActivity.class); 


} 


@Override 
protected Fragment createFragment() { 
return PhotoGalleryFragment.newInstance(); 
} 
接着 , 一 旦 有 了 新 结果 ,就 让 PollService 通 知 用 户 。 也 就 是 说 , 创建 一 个 Notification 
对 象 , 然后 调用 NotificationManager.notify(int, Notification) 方 法 , 如 代码 清单 28-17 


所 示 。 


代码 清单 28-17 添加 通知 信息 ( PollService.java ) 


GOverride 
protected void onHandleIntent(Intent intent) { 























String resultId = items.get(0).getId(); 
if (resultId.equals(lastResultId)) { 

Log.i(TAG, "Got an old result: " + resultId); 
} else { 

Log.i(TAG, "Got a new result: " + result1d); 


Resources resources = getResources(); 
Intent i = PhotoGalleryActivity.newIntent(this); 
PendingIntent pi = PendingIntent.getActivity(this, 0, i, 0); 


Notification notification = new NotificationCompat.Builder(this) 28 


.SetTicker(resources.getString(R.string,new_pictures_titLe) ) 
.SetSmallIcon(android.R.drawable.ic menu_report_image) 
.SetContentTitle(resources.getString(R.string.new pictures_ title)) 
.SetContentText(resources.getString(R.string.new_pictures_text)) 
.SetContentIntent (pi) 

.SetAutoCancel (true) 

.build(); 





NotificationManagerCompat notificationManager = 
NotificationManagerCompat.from(this); 
notificationManager.notify(0, notification); 


} 


QueryPreferences.setLastResultId(this, resultId); 
于 


我 们 来 从 上 至 下 解读 一 下 新 增 代 码 。 首 先 ， 调 用 setTicker(CharSequence) 和 
setSmallIcon(int) 方 法 , 配置 ticker text 和 小 图 标 。( 注意 , 以 android,R.drawabte.ic_menu_ 
report image 包 名 形式 引用 的 图 标 资源 已 内 置 于 Android framework 中 ， 所 以 就 没 必要 再 单独 放 
和 人 资源 文件 夹 了 。) 

然后 , 配置 Notification 在 下 拉 抽 居中 的 外 观 。 虽然 可 以 定制 Notification 视 图 的 外 观 和 
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样式 ， 但 使 用 带 有 图 标 、 标 题 以 及 文字 显示 区 域 的 标准 视图 会 更 容易 些 。 图 标的 值 来 自 于 
setsmallIcon(int) 方 法 ， 而 设置 标题 和 显示 文字 则 需 分 别 调用 setContentTitle 
(CharSequence) 和 setContentText (CharSequence) 方 法 。 

接 下 来 ， 需 指定 用 户 点 击 Notification 消 息 时 所 触发 的 动作 行为 。 与 ALarmManager 类 似 ， 

这 里 使 用 的 是 PendingIntent 。 用 户 在 下 拉 抽 居中 点 击 Notification 消 息 时 ， 传 入 
setContentIntent (PendingIntent) 方 法 的 PendingIntent 会 被 触发 。 调 用 setAutoCancel 

(true) 方 法 可 调整 上 述 行为 。 一 旦 执行 了 setAutoCancel(true) 设 置 方 法 ， 用户 点 击 
Notification 消 息 时 ， 该 消息 就 会 从 消息 抽 居 中 删除 。 

最 后 ， 从 当前 context ( NotificationManagerCompat.from(this) ) 中 取出 一 
NotificationManagerCompat 实 例 ， 然 后 调用 NotificationManagerCompat .notify(... je 
法 贴 出 消息 。 传 和 的 整数 参数 是 通知 消息 的 标识 符 , 在 整个 应 用 中 该 值 应 该 是 唯一 的 。 如 果 使 用 
同一 ID 发 送 两 条 消息 , 则 第 二 条 消息 会 蔡 换 掉 第 一 条 消息 。 在 实际 开发 中 , 这 也 是 进度 条 或 其 他 
动态 视觉 效果 的 实现 方式 。 

本 章 任务 到 此 结束 了 。 运 行 应 用 并 打开 polling 服 务 。 不 一 会 儿 ,， 应 该 就 会 看 到 状态 栏 的 通知 
图 标 。 拉 开通 知 抽 居 ， 就 会 看 到 后 台 服 务 发 送 的 新 结果 消息 。 

既然 后 台 服 务 已 能 正常 工作 ， 那 就 改 用 一 个 更 为 合理 的 定时 器 常量 ， 如 代码 清单 28-18 所 示 。 
(使 用 ALarmManager 的 预定 义 时 间 间 隔 常量 ， 就 可 以 保证 在 KitKat 之 前 的 设备 上 获得 不 那么 精准 
的 重复 定时 需 行 为 。) 


代码 清单 28-18 ”使 用 更 为 合理 的 定时 器 常量 ( PollService.java) 


public class PollService extends IntentService { 
private static final String TAG = "PollService"; 
















































































































































































/A/Set interval to 1 minute 
private static final tong POLL_INTERVAL MS = TimeUnit.MINUTES.toMiltis(1); 
private static final long POLL_ INTERVAL MS = TimeUnit.MINUTES.toMillis(15); 








28.7 ”挑战 练习 : 可 穿戴 设备 上 的 通知 


创建 和 管理 通知 消息 时 ， 如 果 使 用 的 是 NotificationCompat 和 NotificationManager 
Compat 这 两 个 类 ， 通 知 信息 会 自动 出 现在 已 和 手持 设备 配对 的 可 穿戴 设备 上 。 用 户 接收 到 消息 
后 , 癌 左 滑动 ， 就 能 看 到 在 手持 设备 上 打开 应 用 的 选项 。 点 击 它 ， 即 可 在 手持 设备 上 触发 通知 的 
pending intent。 

创建 一 个 Android 可 穿戴 设备 模拟 器 并 与 手持 设备 配对 ， 测 试 一 下 这 种 通知 行为 。 如 果 不 知 
道 怎么 创建 可 穿戴 设备 模拟 器 ， 请 访问 developerandroid.com 求 助 。 







































































28.8 深入 学 习 : 服务 之 细节 


对 于 大 多 数 服 务 任务 , 推荐 使 用 IntentService。 但 IntentService 模 式 不 一 定 适合 所 有 哥 
构 , 因此 有 必要 进一步 了 解 并 掌握 服务 , 以 便 自 己 实现 相关 服务 。 做 好 接受 信息 双 炸 的 心理 准备 。 
接 下 来 ， 我 们 将 学 习 大 量 有 关 服 务 使 用 的 详细 内 容 与 复杂 细节 。 


28.8.1 服务 的 能 与 不 能 


与 activity 一 样 ， 服 务 是 一 个 有 生命 周期 回调 方法 的 应 用 组 件 。 这 些 回 调 方法 同样 也 会 在 主 
UI 线程 上 运行 ， 和 activity 里 的 一 样 。 
原生 服务 不 能 在 后 台 线 程 上 运行 。 这 也 是 我 们 推荐 使 用 IntentService 的 最 主要 原因 。 大 多 
数 重要 服务 都 需要 在 后 台 线 程 上 运行 ， 而 IntentService 已 提供 了 一 套 标准 支持 方案 。 

下 面 来 看 看 服务 有 哪些 生命 周期 回调 方法 。 


28.8.2 ”服务 的 生命 周期 


如 果 是 startSservice(Intent ) 方 法 启动 的 服务 ， 其 生命 周期 很 简单 ， 并 有 三 种 生命 周期 回 
调 方法 。 
口 onCreate(...) 方 法 : 服务 创建 时 调用 。 
口 onStartCommand(Intent, int,int) 方 法 : 每 次 组 件 通 过 startService(Intent ) 方 法 
启动 服务 时 调用 一 次 。 它 有 两 个 整数 参数 ， 一 个 是 标识 符 集 ， 一 个 是 启动 DD。 标 识 符 集 
用 来 表示 当前 intent 发 送 究 竞 是 一 次 重新 发 送 ， 还 是 一 次 从 没 成 功 过 的 发 送 。 每 次 调用 
onStartCommand(Intent, int,int) 方 法 ， 启 动 ID 都 会 不 同 。 因 此 ， 启 动 ID 也 可 用 于 区 
分 不 同 的 命令 。 
口 onDestroy() 方 法 : 服务 不 再 需要 时 调用 。 
服务 停止 时 会 调用 onDestroy() 方 法 。 服 务 停止 的 方式 取决 于 服务 的 类 型 。 服 务 的 类 型 
onStartCommand(...) 方 法 的 返回 值 确定 ， 可 能 的 服务 类 型 有 Service.START_NOT_STICKY、 
START_ REDELIVER INTENT 和 START STICKY。 



































































































































28.8.3 ”non-sticky 服务 

















IntentService 是 一 种 non-sticky 服 务 。non-sticky 服 务 在 服务 自己 认为 已 完成 任务 时 停止 。 
为 获得 non-sticky 服 务 ， 应 返回 START_NOT_STICKY 或 START_REDELIVER INTENT。 

通过 调用 stopSelf() 或 stopSelf(int) 方 法 ,我 们 告诉 Android 任 务 已 完成 。stopSelf() 
是 个 无 条 件 方法 。 不 管 onStartCommand(... ) 方 法 调用 多 少 次 ， 该 方法 总 是 会 成 功 停止 服务 。 

stopSeLf(int) 是 个 有 条 件 的 方法 。 该 方法 需要 来 自 于 onStartCommand ( .. . ) 方 法 的 启动 
ID。 只 有 在 接收 到 最 新 启动 ID 后 ， 该 方法 才 会 停止 服务 。( 这 也 是 IntentService 的 后 台 工 作 原 
理 。) 
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返回 START_NOT_STICKY 和 START_REDELIVER_INTENT 有 什么 不 同 呢 ? 区 别 就 在 于 , 如 果 系 
统 需 要 在 服务 完成 任务 之 前 关闭 它 ， 则 服务 的 具体 表现 会 有 所 不 同 。START_NOT_STICKY 型 服务 
说 没 就 没 了 ; 而 START_REDELIVER_INTENT 型 服务 则 会 在 资源 不 再 吃紧 时 ， 尝 试 再 次 启动 服务 。 

选择 START_NOT_STICKY 还 是 START_REDELIVER_INTENT， 这 要 看 服务 对 应 用 有 多 重要 了 。 
如 果 不 重要 ， 就 选择 START_NOT_STICKY。 在 PhotoGallery 应 用 中 ， 服 务 根据 定时 器 的 设 定 重复 运 
行 。 即 使 发 生 问题 ， 也 不 会 有 严重 后 果 ， 因 此 应 选择 START_NOT_STICKY ， 同 时 ， 它 也 是 
IntentService 的 默认 行为 。 如 有 需要 ， 我 们 也 可 调用 IntentService.setIntentRedeLivery 
(true) 方 法 ， 改 用 START_REDELIVER INTENT。 












































28.8.4 sticky 服务 


sticky 服 务 会 持续 运行 ， 直 到 外 部 组 件 调 用 Context .stopService(Intent ) 方 法 让 它 停止 。 
为 获得 sticky 服 务 ， 应 返回 START_STICKY。 

sticky 服 务 启动 后 会 持续 运行 , 除非 某 个 组 件 调 用 Context .stopService(Intent) 方 法 停止 
它 。 如 因 某 种 原因 需 终 止 服务 ， 可 传人 一 个 null intent 给 onStartCommand ( ,,, ) 方 法 重启 服务 。 

sticky 服 务 适用 于 长 时 间 运 行 的 服务 ， 如 音乐 播放 器 这 种 启动 后 一 直 运 行 ， 直 到 用 户主 动 停 
止 的 服务 。 即 使 是 这 样 ， 也 应 考虑 一 种 使 用 non-sticky 服 务 的 蔡 代 架构 方案 。sticky 服 务 的 管理 很 
不 方便 ， 因 为 很 难 判断 服务 是 否 已 启动 。 









































28.8.5 绑 定 服务 


除 以 上 各 类 服务 外 ， 也 可 使 用 bindSservice(Intent,ServiceConnection，int) 方 法 绑 定 
一 个 服务 ， 以 此 获得 直接 调用 绑 定 服务 方法 的 能 力 。ServiceConnection 是 代表 服务 绑 定 的 一 
个 对 象 ， 负 责 接收 全 部 绑 定 回调 方法 。 

在 fragment 中 ， 绑 定 代码 可 能 是 这 样 的 : 


private ServiceConnection mServiceConnection = new ServiceConnection() { 
public void onServiceConnected(ComponentName className, 
IBinder service) { 
// Used to communicate with the service 
MyBinder binder = (MyBinder)service; 
































} 
public void onServiceDisconnected(ComponentName className) { 
} 

}; 

@Override 


public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


Intent i = new Intent(getActivity(), MyService.class); 
getActivity().bindService(i, mServiceConnection, 0); 
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@Override 

public void onDestroy() { 
super.onDestroy(); 
getActivity().unbindService(mServiceConnection); 


} 
对 服务 来 说 ， 绑 定 引 入 了 另外 两 个 生命 周期 回调 方法 。 
口 onBind(Intent ) 方 法 :每 次 绑 定 服务 时 调用 , 返回 来 自 ServiceConnection.onService 
Connected (ComponentName,IBinder) 方 法 的 IBinder 对 象 。 
口 onUnbind(Intent) 方 法 : 服务 绑 定 终止 时 调用 。 

1. 本 地 服务 绑 定 

MyBinder 是 怎样 一 种 对 象 呢 ? 如 果 服 务 是 个 本 地 服务 ，MyBinder 很 可 能 就 是 本 地 进程 中 的 
一 个 简单 Java 对 象 。 通 常 ，MyBinder 用 于 提供 一 个 句柄 ， 以 便 直接 调用 服务 方法 : 


private class MyBinder extends IBinder { 
public MyService getService() { 
return MyService.this; 





























} 
} 


@Override 
public void onBind(Intent intent) { 
return new MyBinder(); 


} 

这 种 模式 看 上 去 让 人 激动 。 这 是 Android 系 统 中 唯一 一 处 支持 组 件 间 直接 对 话 的 地 方 。 不 过 ， 
我 们 并 不 推荐 此 种 模式 。 服 务 是 种 高 效 的 单 例 , 与 仅 使 用 一 个 单 例 相 比 , 使 用 此 种 模式 显现 不 出 
优势 。 

2. 远程 服务 绑 定 

绑 定 更 适用 于 远程 服务 ， 因 为 它们 赋予 了 其 他 进程 中 应 用 调用 服务 方法 的 能 力 。 创 建 远 程 
绑 定 服务 属于 高 级 主题 ， 不 在 本 书 讨论 范畴 。 请 查阅 Android 文 档 中 的 AIDL 指 导 或 Messenger 
类 细节 。 
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本 章 ， 我 们 已 知道 如 何 让 ALarmManager 、IntentService 和 PendingIntent 相 互 配 合 ， 创 
建 周期 性 的 后 台 服 务 。 实 现 一 个 完全 可 用 的 后 台 服 务 还 有 几 件 事 要 做 : 
口 计划 一 个 周期 性 任务 ; 
口 检查 周期 性 任务 的 运行 状态 ; 
口 检查 网 络 是 否 可 用 。 

搭配 使 用 一 些 API， 我 们 也 能 手工 创建 一 个 能 够 启 停 、 基 本 可 用 的 后 台 服 务 。 虽 然 可 行 ， 但 
工作 量 很 大 。 
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在 Lollipop (API21 ) 系统 中 , 为 更 好 地 实现 后 台 服 务 ，Android 引 入 了 一 个 叫 ]obschedutLer 
的 全 新 API。 除了 能 用 来 处 理 各 类 任务 外 ，JobScheduler 还 能 做 到 更 多 : 发 现 没有 网 络 时 ， 它 能 
禁止 服务 启动 ; 如 果 请 求 失败 或 网 络 连 接受 限 , 它 能 提供 稍 后 重 试 机 制 ; 它 能 控制 只 在 设备 充电 
的 时 候 ， 才 允许 联网 检查 是 否 有 新 图 片 。 虽 然 上 述 某 些 场景 使 用 AlarmManager 和 IntentService 也 
可 能 实现 ， 试 试 就 知道 了 ， 那 绝对 不 容易 。 

除了 实现 常规 后 台 服 务 之 外 ，JobSschedutLer 还 支持 按 场景 、 按 条 件 运行 后 台 服 务 。 下 面 就 
来 看 看 它 的 工作 原理 。 首 先 ， 创建 一 个 处 理 任 务 的 服务 ( 使 用 Jobservice 子 类 )。JobService 
有 两 个 可 履 羡 方法 : onStartjJob(JobParameters) 和 onStopJob(JobParameters)。 (注意, 以 下 
代码 仅 供 讨 论 之 用 ， 不 用 找 地 方 输入 。 ) 


public class PollService extends JobService { 
@Override 
public boolean onStartJob(JobParameters params) { 
return false; 




















} 


@Override 
public boolean onStopJob(JobParameters params) { 
return false; 
} 
} 


Android 准 备 好 执行 任务 时 ， 服 务 就 会 启动 ， 此 时 会 在 主线 程 上 收 到 onStartJob(...) 方 法 
调用 。 该 方法 返回 false 结 果 表 示 :“ 交 代 的 任务 我 已 全 力 去 做 ,现在 做 完了 。” 返 回 true 结 果 则 
表示 :“ 任 务 收 到 ， 正 在 做 ,但 是 还 没有 做 完 。” 

与 IntentService 不 同 , JobService 需 要 你 单 开 新 线程 , 这 点 比较 麻烦 。 可 使 用 AsyncTask 
按 如 下 方式 创建 新 线程 


private PollTask mCurrentTask 














@Override 

public boolean onStartJob(JobParameters params) { 
mCurrentTask = new PollTask(); 
mCurrentTask.execute(params); 
return true; 


} 

private class PollTask extends AsyncTask<JobParameters,Void,Void> { 
@Override 
protected Void doInBackground(JobParameters... params) { 


JobParameters jobParams = params[0]; 
// Poll Flickr for new images 


jobFinished(jobParams, false); 
return null; 
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任务 完成 后 ， 就 可 以 调用 jobFinished(JobParameters，bootean ) 方 法 通知 结果 。 不 过 ， 
如 果 该 方法 的 第 二 个 参数 传人 true 的 话 ， 就 等 于 说 :“ 事 情 这 次 做 不 完了 ， 请 计划 在 下 次 某 个 时 


间 继 续 吧 。” 


任务 运行 时 也 可 能 会 收 到 onSstopJob(JobParameters) 调 用 ， 表 明 当 前 任务 需 中 断 。 例 如 ， 
用 户 通 常 需 要 服务 在 有 WiFi 连 接 时 才 运 行 。 如 果 任 务 还 在 处 理 ， 手 机 就 离开 了 WiFi 履 盖 区 ， 
onStopJob(. . .) 方 法 就 会 被 调用 ， 也 就 是 说 ， 一 切 任务 应 立即 停止 。 


@Override 








public boolean onStopJob(JobParameters params) { 
if (mCurrentTask != null) { 
mCurrentTask.cancel (true); 


} 

return true; 
} 
调用 onStopJob ( . 











. ) 方 法 就 是 表明 ， 服 务 马 上 就 要 停 掉 了 。 不 要 抱 有 幻想 ， 请 立即 停止 手 


头 上 的 一 切 事情 。 这 里 ， 返回 true 表 示 :“ 任 务 应 该 计划 在 下 次 继续 。” 返回 faLse 表 示 :“ 不 管 








怎样 ， 事 情 到 此 结束 吧 ， 不 要 计划 下 次 了 。 
在 manifest 配 置 文件 中 登记 服务 时 ， 必 须 导 出 它 并 为 它 添 加 权限 : 





<Service 





android:name=".PollService" 
android:permission="android.permission.BIND JOB SERVICE" 
android:exported="true"/> 

















所 谓 导出 服务 ， 就 是 把 服务 暴露 出 来 ,但 添加 的 权限 控制 只 有 JobScheduler 才 能 运行 它 。 
一 旦 创建 了 JobService, 启动 它 就 非常 迅速 了 。 你 可 以 使 用 JobScheduler 检 查 是 否 已 计划 


好 了 任务 。 








final int JOB ID = 1; 


JobScheduler scheduler = (JobScheduler) 
context.getSystemService(Context.JOB SCHEDULER SERVICE); 


boolean hasBeenScheduled = false; 
for (JobInfo jobInfo : scheduler.getAllPendingJobs()) { 


if (jobInfo. 


getId() == JOB ID) { 


hasBeenScheduled = true; 


} 
} 





如 果 还 没有 ， 可 以 创建 一 个 新 的 JobInfo 说 明 你 期 望 的 任务 运行 时 间 。 咽 ，PoLLSservie 应 
该 在 什么 时 候 和 运行 呢 ? 这 样 如 何 : 


final int JOB ID = 1; 


JobScheduler sch 


eduler = (JobScheduler) 


context.getSystemService(Context.JOB SCHEDULER SERVICE); 


JobInfo jobInfo 


= new JobInfo.Builder( 
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JOB ID, new ComponentName(context, PollService.class)) 
.SetRequiredNetworkType(JobInfo.NETWORK TYPE UNMETERED) 
.SetPeriodic(1000 * 60 * 15) 
.SetPersisted(true) 
.build(); 

scheduler.schedule(jobInfo); 


上 述 代 码 计划 任务 每 15 分 钟 运行 一 次 ,但 前 提 条 件 是 有 WiFi 或 有 不 限 流量 网 络 可 用 。 调 用 
setPersisted(true) 方 法 可 保证 服务 在 设备 重启 后 也 能 按 计 划 运 行 。 还 可 采用 其 他 方式 配置 
JobInfo， 具 体 做 法 请 参阅 Android 开 发 者 文档 。 


JobScheduler 和 未 来 的 后 台 服 务 


本 章 介绍 不 使 用 JobSschedutLer 的 前 提 下 如 何 实现 后 台 服 务 。 没 办 法 ， 只 有 Lollipop 及 其 之 后 
的 系统 才 支 持 JobScheduler， 而 且 它 也 没有 支持 库 版 实现 。 本 章 基于 AlarmManager 实 现 的 定时 服 
务 是 唯一 可 行 的 标准 库 解决 方案 ， 可 以 支持 各 个 Android 系 统 版 本 。 

然而 ， 有 个 重要 的 讯息 要 告诉 你 ，AlarmManager 人 处理 后 台 服 务 的 日 子 应 该 不 长 了 。 近 年 ， 
Android 平 台 开 发 人 员 有 好 几 个 高 优先 级 的 目标 要 实现 , 其 中 有 个 目标 是 尽量 改善 电池 使 用 效率 ， 
提高 设备 的 续航 时 间 。 因 此 ， 对 于 那些 使 用 WiFi、GPS 而 特别 耗 电 的 应 用 ， 他 们 一 直 在 设法 能 绝 
对 控制 各 种 场景 下 的 任务 调度 。 

这 也 是 这 些 年 来 AlarmManager 一 直 不 停 在 变 的 原因 : Android 知 道 开 发 人 员 都 在 用 

AlarmManager 计 划 后 台 服 务 。 为 让 应 用 运行 更 加 高 效 ， 这 些 个 API 必 须 不 断 地 优化 。 

然而 ， 实 际 上 ， 就 处 理 后 台 定 时 器 服务 这 些 任务 来 说 ，AlarmManager 并 不 是 个 合格 的 选手 。 
用 户 在 做 什么 呢 ， 是 在 使 用 GPS 定位 ， 还 是 在 更 新 应 用 widget 皮肤 ， 它 不 知道 ， 自 然 也 就 无 法 告 
诉 系统 。 既 然 Android 系 统 掌握 不 了 应 用 使 用 情况 ， 那 它 只 能 毫 无 差别 地 处 理 各 个 定时 器 任务 ， 
如 何 合理 调度 高 效 节能 自然 也 就 无 从 谈 起 。 

在 此 压力 下 ， 相 信 一 旦 JobScheduler 普 及 开 来 ，Android 就 会 立即 抛弃 AlarmManager。 所 以 ， 
我 们 建议 ， 只 要 你 觉得 可 行 ， 应 尽早 使 用 JobScheduler。 

如 果 你 不 打算 在 将 来 做 痛苦 的 迁移 ,现在 就 想 用 起 来 ,可 以 试 试 第 三 方 兼容 库 。 目 前 ,Evernote 
的 android-job 是 最 好 的 选择 。 可 以 在 github.com/evernote/android-job 找 到 它 。 


28.10 ”挑战 练习 : 在 Lollipop 设备 上 使 用 JobService 


请 创建 另 一 个 PoLLService 实 现 版 本 。 新 的 PoLLService 应 该 继承 JobSservice 并 使 用 
JobSchedutLer。 在 PoLLService 启 动 代码 中 ， 检 查 系 统 版 本 是 否 为 Lollipop : 如 果 是 ， 就 使 用 
JobScheduler 计 划 运 行 ]JobService; 如 果 不 是 ， 依 然 使 用 ALarmManager 实 现 。 



















































































































































































28.11 深入 学 习 : sync adapter 
你 还 可 以 使 用 sync adapter 创 建 常 规 的 polling 网 络 服务 。 和 前 面 看 到 过 的 adapter 不 一 样 ，sync 
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adapter 主 要 用 于 从 某 个 数据 源 同 步 数 据 ( 上传、 下 载 或 既 上 传 又 下 载 ), 不 像 JobScheduler, sync 
adapter 早 就 有 了 ， 所 以 不 用 担心 新 旧 系统 版 本 问题 。 

和 JobScheduler 一 样 ，sync adapter 可 代替 PhotoGallery 应 用 中 的 ALarmManger。 不 同 应 用 中 
的 同步 功能 都 是 默认 一 起 执行 的 。 而 且 , 即使 设备 重启 , 也 不 用 重 置 同步 定时 器 , 因为 Sync adapter 
会 自动 处 理 。 

sync adapter 还 能 和 操作 系统 完美 整合 。 你 可 以 设置 一 个 可 同步 账户 ， 对 外 暴露 应 用 。 然 后 ， 
用 户 通过 Settings 一 Accounts 菜 单 来 管理 应 用 的 同步 。 当 然 ， 这 个 菜单 还 可 以 用 来 管理 其 他 使 用 
sync adapter 的 应 用 账户 ， 如 Google 自 己 的 一 些 应 用 套件 ， 如 图 28-2 所 示 。 
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图 28-2 ”账户 设置 


虽然 使 用 sync adapter 既 能 让 周期 性 的 网 络 任务 变 得 容易 可 靠 , 又 能 让 开发 者 免 于 编写 定时 器 
管理 和 pending intent 的 相关 代码 ， 但 仍然 免不了 写 男 外 一 些 代码 。 首 先 ， 需 要 与 网 络 请 求 相关 的 
代码 (如 FlickFetchr )。 其 次 ， 要 有 一 个 content provider 实 现 来 封装 数据 、 账 户 和 授权 类 ， 用 以 
代表 远程 服务 器 的 某 个 账户 ( 即使 远程 服务 器 不 需要 授权 )， 以 及 一 个 sync adapter 和 sync service 
的 实现 。 另 外 ， 还 要 懂得 运用 绑 定 服 务 。 

所 以 , 如 果 应 用 已 经 使 用 content provider 作 为 数据 层 , 并 且 需 要 账号 授权 , 那 使 用 sync adapter 
是 最 理想 的 。 此 外 ， 相 较 于 JobScheduler，sync adapter 还 有 同 操 作 系 统 提供 的 用 户 界面 自然 整 
合 的 优势 。 考 虑 到 这 些 因素 ， 即 使 要 写 一 大 堆 代 码 ， 某 些 场景 下 ， 仍 然 值得 使 用 sync adapter。 

在 线 开发 者 文档 提供 了 sync adapter 使 用 教程 : developer android.comytraining/sync-adapters/ 
index.html。 
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本 章 ， 我 们 继续 从 两 个 方面 完善 PhotoGallery 应 用 。 首 先 ， 让 应 用 轮 询 新 结果 并 在 有 所 发 现 
时 及 时 通知 用 户 ， 即 使 用 户 重启 设备 后 还 没有 打开 过 应 用 。 其 次 ,保证 用 户 在 使 用 应 用 时 不 出 现 
新 结果 通知 。( 用 户 开 了 应 用 ， 已 看 到 刷新 显示 的 新 的 搜索 图 片 ， 同 时 还 收 到 了 新 结果 通知 ， 你 
说 是 不 是 既 多 余 又 烦人 ? ) 

借 此 升级 ， 我 们 将 学 习 如 何 监听 系统 发 送 的 broadcast intent， 以 及 如 何 使 用 broadcast receiver 
处 理 它们 。 此 外 ， 我 们 会 在 应 用 运行 时 动态 发 送 与 接收 broadcast intent。 最 后 ， 还 会 使 用 有 序 
broadcast 判 断 应 用 是 否 在 前 台 运 行 。 


























29.1 普通 intent 和 broadcast intent 


Android 设 备 中 ， 各 种 事件 时 有 发 生 。WiFi 时 有 时 无 ， 软 件 装卸 ， 电 话 接 打 ， 短 信 收 发， 等 
等 。 

许多 系统 组 件 需 要 掌握 这 些 动态 。 为 满足 这 样 的 需求 ，Android 提 供 了 broadcast intent 组 件 。 
broadcast intent 的 工作 原理 类 似 之 前 学 过 的 intent, 唯一 不 同 的 是 broadcast intent 可 同时 被 多 个 叫 作 
broadcast receiver 的 组 件 接 收 ( 如 图 29-1 所 示 )。 

































intent broadcast intent 
PhotoGallery (你 的 组 件 ) (你 疯 组 件 ) 
Intent(DO_SOMETHING) 一 一 ”一 -一 一 Intent(SOMETHING_HAPPENED) 一 一 一 一 一 
人 



























(其 他 组 件 ) 
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其 他 组 件 ) 


图 29-1 普通 intent 与 broadcast intent 
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作为 公共 API 的 一 部 分 ,无 论 什 么 时 候 ，activity 和 服务 应 该 都 可 以 响应 隐 式 intent。 如 果 是 用 
作 私 有 API， 用 用 显 式 intent 差 不 多 也 够 了 。 这 样 看 来 ， 还 需要 broadcast intent 的 话 ， 理 由 只 有 一 
个 : 它 可 以 发 送 给 多 个 接收 者 。 虽 然 broadcast receiver 也 能 响应 显 式 intent， 但 几乎 没 人 这 么 用 ， 
因为 显 式 intent 只 允许 有 一 个 接收 者 。 


29.2 ”接收 系统 broadcast: 重启 后 唤醒 


PhotoGallery 应 用 的 后 台 定 时 需 虽 然 能 用 ， 但 还 不 够 完美 。 如 果 用 户 重启 了 设备 ， 定 时 需 就 
会 失效 。 

设备 重启 后 ， 那 些 持续 运行 的 应 用 通常 也 需要 重启 。 监 听 带 有 B00T_COMPLETED 操 作 的 
broadcast intent ， 可 知道 设备 是 否 已 完成 启动 。 无 论 何 时 ， 只 要 打开 设备 ， 系 统 就 会 发 送 一 个 
BOOT_COMPLETED broadcast intent。 要 想 监听 它 , 可 以 创建 并 登记 一 个 standalone broadcast receiver。 















































29.2.1 创建 并 登记 standalone receiver 


standalone receiver 是 一 个 在 manifest 配 置 文件 中 声明 的 broadcast receiver。 即 便 应 用 进程 已 消 
亡 ，standalone receiver 也 可 以 被 激活 。( 稍 后 还 会 学 习 到 可 以 同 fragment 或 activity 的 生命 周期 绑 定 
的 dynamic receiver。) 

与 服务 和 activity 一 样 ，broadcast receiver 必 须 在 系统 中 登记 后 才能 用 。 如 果 不 登记 ， 系 统 就 
不 知道 该 向 哪里 发 送 intent。 自然 , broadcast receiver 的 onReceive(...) 方 法 也 就 不 能 按 预期 被 调 
用 了 。 

要 登记 broadcast receiver， 首 先 要 创建 它 。 创 建 一 个 StartupReceiver 新 类 ， 继承 android. 
content .BroadcastReceiver 类 ， 如 代码 清单 29-1 所 示 。 

















代码 清单 29-1 第 一 个 broadcast receiver ( StartupReceiver.java ) 
public class StartupReceiver extends BroadcastReceivert{ 


private static final String TAG = "StartupReceiver"; 


@Override 
public void onReceive(Context context, Intent intent) { 
Log.i(TAG, "Received broadcast intent: " + intent.getAction()); 
} 
} 


与 服务 和 activity 一 样 , broadcastreceiver 是 接收 intent 的 组 件 。 当 有 intent 发 送 给 StartupReceiver 
时 ， 它 的 onReceive(. .,) 方 法 会 被 调用 。 
打开 AndroidManifest xml 配 置 文件 ， 登记 上 StartupReceiver， 如 代码 清单 29-2 所 示 。 


代码 清单 29-2 ”在 manifest 文 件 中 添加 receiver ( AndroidManifest.xml ) 


<manifest ...> 


<uses-permission android:name="android.permission.INTERNET"/> 
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<uses-permission android:name="android.permission.ACCESS NETWORK STATE"/> 
<uses-permission android:name="android.permission.RECEIVE BOOT_COMPLETED" /> 


<application 
i 
<activity 
android:name=" .PhotoGalleryActivity" 
android:label="@string/app_name"> 


</activity> 
<service android:name=".PollService"/> 
<receiver android:name=".StartupReceiver"> 
<intent-filter> 
<action android:name="android.intent.action.BOOT_COMPLETED"/> 
</intent-filter> 


</receiver> 
</application> 


</manifest> 


登记 响应 隐 式 intent 的 standalone receiver 和 登记 服务 或 activity 差 不 多 。 我 们 使 用 receiver 标 
签 并 在 其 中 包含 相应 的 jntent-filter。StartupReceiver 会 监听 B00T_COMPLETED 操 作 ， 而 该 
操作 也 需要 配置 使 用 权限 。 因 此 ， 还 需要 添加 一 个 相应 的 uses -permission 标 签 。 

在 配置 文件 中 完成 声明 后 , 即使 应 用 还 没 运行 ,只 要 有 匹配 的 broadcast intent 发 来 ，broadcast 
receiver 就 会 醒 来 接收 。 一 收 到 intent，broadcast receiver 的 onReceive(Context，Intent ) 方 法 即 
开始 运行 ， 随 后 会 被 销毁 ( 如 图 29-2 所 示 )。 























Android 操 作 系 统 | PhotoGallery 


| 
BooT coMpLETED 
StartupReceiver 


图 29-2 ”接收 B00T_COMPLETED 


设备 重启 后 , StartupReceiver 的 onReceive(...) 方 法 会 被 调用 吗 ? 现 在 就 来 验证 ,。 首先， 
运行 更 新 版 PhotoGallery 应 用 。 

然后 ， 关 闭 设 备 。 如 果 是 物理 设备 ， 按 电源 键 关机 。 如 果 是 模拟 器 ， 关 机 的 最 简 方 法 是 直接 
退出 模拟 器 应 用 。 

打开 设备 。 如 果 是 物理 设备 ， 按 电源 键 开 机 。 如 果 是 模拟 器 ， 要 么 重新 运行 应 用 ， 要 么 使 用 
AVD Manager 启 动 应 用 ,但 要 保证 使 用 的 是 刚 关 掉 的 那个 模拟 器 。 
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现在 ， 选 择 Tools 一 Android 一 Android Device Monitor 荣 单项 打开 Android Device Monitor。 

点 击 Android Device Monitor 的 Devices 选 项 卡 中 的 设备 。( 如 果 看 不 到 设备 列表 ,请 尝试 插 拨 
USB 设 备 或 重启 模拟 器 。) 

在 Android Device Monitor 窗 口中 ， 以 Received broadcast intent 关 键 字 搜索 LogCat 输 出 ( 如 图 
29-3 所 示 )。 








@@g@ Android Device Monitor 
是 敬 5aS| 兰 目 ， .Qu， 
= 日 [ww | 呈 口 ] 
目 bwices 和 和 急 Threads 3 | 目 Heap| 目 Allocation ..，| 令 Network SL.， 乙 , File Explorer | 者 Emulator C... | 口 system Int... 
区 目 基 自 和 艺 训 多 pe 但 rw no client is selected 
Name 
T 国 Nexus_5.… Online Nexus_... 
com.andr... 1633 8600 
com.bign... 2145 8601 
com.andr... 1794 8602 
com.andr... 1826 8603 
com,andr... 1603 8604 
com,andr.., 1446 8605 
com,andr... 1738 8606 
com.andr.，1387 8607 
com.andr... 1965 8608 
com.andr... 1647 8609 
com.andr... 1776 8610 
com.andr... 1872 8611 
池 Logcat 3 Console ” 口 
SavedFiters 学 一 妈 Received broadcast intent] | | verbose 日 日 国 口 圭 
All messages (no filters) 
t ) Le Time PID TD Application Tag Text 


I 94-08 12:40:58.156 1989 1989 StartupRecei- Received broadcast intent: android.intent.action.B00T_COMPLETED 


28M of568M 测 


图 29-3 ”搜索 LogCat 输 出 


在 LogCat 中 ， 可 以 看 到 表明 receiver 运 行 的 日 志 。 但 如 果 在 设备 标签 页 查看 设备 ， 则 可 能 
不 到 任何 PhotoGallery 进 程 。 这 是 因为 进程 一 运行 完 broadcast receiver， 就 随即 消亡 了 。 

(使 用 Logcat 输 出 测试 receiver 的 运行 不 一 定 总 会 成 功 ， 使 用 模拟 器 更 有 可 能 。 按 照 上 述 步 又 
操作 ， 如 果 看 不 到 log 日 志 ， 建 议 多 试 几 次 。 还 是 不 行 的话 ， 那 就 暂时 放弃 ， 等 学 习 到 优化 通知 
消息 时 ， 就 会 有 更 可 靠 的 办 法 来 验证 receiver 的 运行 了 。 ) 











29.2.2 ”使 用 receiver 


broadcast receiver 的 生命 非常 短暂 ， 因 而 难以 有 所 作为 。 例 如 ， 我 们 无 法 使 用 任何 异步 API 
或 登记 任何 监听 器 ， 因 为 一 旦 onReceive(Context，Intent ) 方 法 运行 完 ，receiver 就 不 存在 了 。 
onReceive (Context, Intent) 方 法 同样 运行 在 主线 程 上 ,因此 不 能 在 该 方法 内 做 一 些 费 时 费力 
的 事情 ， 如 网 络 连接 或 数据 的 永久 存储 等 。 

然而 ， 这 并 不 代表 receiver 一 无 用 处 。 一 些 便利 型 任务 就 非常 适合 它 ， 比 如 启动 activity 或 服 
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务 (不 需要 等 返回 结果 )， 以 及 系统 重启 后 重 置 定时 运行 的 定时 器 。 
receiver 需 要 知道 定时 需 的 启 停 状态 。 为 存储 它 的 状态 , 在 QueryPreferences 类 中 添加 一 个 
preference 常 量 和 两 个 便利 方法 ， 如 代码 清单 29-3 所 示 。 


代码 清单 29-3 ”添加 定时 器 状态 preference ( QueryPreferences.java ) 


public class QueryPreferences { 











private static final String PREF SEARCH QUERY = "searchQuery"; 
private static final String PREF LAST RESULT ID = "lastResult1d"; 
private static final String PREF_IS ALARM ON = "isAlarmOn"; 


public static void setLastResultId(Context context, String LastResuLtId) { 


} 


public static boolean isAlarmOn(Context context) { 
return PreferenceManager.getDefaultSharedPreferences(context) 
.getBoolean(PREF_IS ALARM ON, false); 
} 


public static void setAlarmOn(Context context, boolean isOn) { 
PreferenceManager.getDefaultSharedPreferences (context) 
.edit() 
.putBoolean(PREF_IS ALARM ON, isOn) 
"apply(); 


3 
接 下 来 ,更 新 PollService.setServiceAlarm(...) 方 法 , 在 设置 定时 器 后 存 下 它 的 状态 ， 
如 代码 清单 29-4 所 示 。 


代码 清单 29-4 存储 定时 器 状态 ( PollService.java ) 
public class PollService extends IntentService { 
public static void setServiceAlarm(Context context, boolean ison) { 
if (isOn) { 


alarmManager.setRepeating(AlarmManager .ELAPSED REALTIME, 
SystemClock.elapsedRealtime(), POLL INTERVAL MS, pi); 


} else { 
alarmManager.cancel (pi); 
pi.cancel(); 

} 


QueryPreferences.setAlarmOn(context, isOn); 


这 样 ， 设 备 重启 后 ，StartupReceiver 就 能 用 它 打开 定时 器 ， 如 代码 清单 29-5 所 示 。 





29.3 过滤 前 台 通 知 消息 479 





代码 清单 29-5 ”设备 重启 后 启动 定时 器 〈StartupReceiverjava ) 
public class StartupReceiver extends BroadcastReceivert{ 


private static final String TAG = "StartupReceiver"; 


@Override 
public void onReceive(Context context, Intent intent) { 
Log.i(TAG, "Received broadcast intent: " + intent.getAction()); 


boolean ison = QueryPreferences.isAlarmOn(context); 
PollService.setServiceAlarm(context, isOn); 


} 
再 次 运行 PhotoGallery 应 用 ( 为 方便 测试 ， 可 设置 一 个 较 短 的 时 间 间 隔 ， 如 60 秒 )。 点 击 工具 
栏 的 START POLLING 打 开 服务 。 重 启 设备 。 这 次 ,后台 polling 服 务 应 该 会 重启 了 。 


29.3 过 滤 前 台 通 知 消息 


解决 了 设备 重启 后 的 服务 唤醒 问题 ， 再 来 看 PhotoGallery 应 用 的 另 一 缺陷 。 通 知 消息 虽然 很 
有 用 ,但 应 用 开 着 的 时 候 不 应 该 收 到 通知 消息 。 

同样 ， 我 们 使 用 broadcast intent 来 解决 这 个 问题 ， 但 用 法 和 以 前 完全 不 同 。 

首先 ， 我 们 发 送 (或 接收 ) 定制 版 broadcast intent ( 最 后 会 锁定 它 ， 只 人 允许 PhotoGallery 应 用 
部 件 接收 它 )。 其 次 ,不 再 使 用 manifest 文 件 ， 改 用 代码 为 broadcast intent 动 态 登记 receiver。 最 后 ， 
发 送 一 个 有 序 broadcast 在 一 组 receiver 中 传递 数据 ， 借 此 保证 最 后 才 运 行 某 个 receiver。( 不 太 理 解 
这 段 话 ? 别 担心 ， 跟 着 做 ， 很 快 就 会 明白 了 。) 


29.3.1 发 送 broadcast intent 


首先 处 理 最 容易 的 部 分 : 发 送 自己 定制 的 broadcast intent。 具 体 来 讲 ， 就 是 发 送 broadcast 通 
知 目 标 部 件 有 新 的 搜索 结果 消息 了 。 要 发 送 broadcast intent ， 只 需 创 建 一 个 intent ， 并 传人 
sendBroadcast(Intent) 方 法 即 可 。 这 里 ， 需 要 通过 sendBroadcast (Intent ) 方 法 广播 自 定 义 
的 操作 〈action )， 因 此 还 需要 定义 一 个 操作 常量 。 

在 PollService 类 中 ,输入 代码 清单 29-6 所 示 代 码 。 


代码 清单 29-6 ”发 送 broadcast intent ( PollService.java ) 


public class PollService extends IntentService { 
private static final String TAG = "PollService"; 
























































private static final long POLL iNTERVAL MS = TimeUnit.MINUTES.toMillis(15); 


public static final String ACTION_ SHOW_ NOTIFICATION = 
"com.bignerdranch.android.photogallery .SHOW_ NOTIFICATION"; 

@Override 

protected void onHandleIntent(Intent intent) { 
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String resultId = items.get(0).getId(); 
if (resultId.equals(lastResultId)) { 

Log.i(TAG, "Got an old result: " + resultId); 
} else { 


NotificationManagerCompat notificationManager = 
NotificationManagerCompat.from(this); 
notificationManager.notify(0, notification); 


sendBroadcast(new Intent(ACTION SHOW_ NOTIFICATION)); 
} 


QueryPreferences.setLastResultId(this, resultId); 


} 
现在 ， 只 要 有 新 结果 ， 应 用 就 会 对 外 广播 。 


29.3.2 ”创建 并 登记 动态 receiver 
完成 intent 的 发 送 后 ， 接 下 来 的 任务 是 使 用 receiver 接 收 ACTION SHOW_NOTIFICATION 


broadcast intent。 

可 以 编写 一 个 类 似 于 StartupReceiver 的 standalone broadcast receiver 来 接收 intent， 并 在 
manifest 文 件 中 登记 ; 但 这 里 行 不 通 。 你 需要 在 PhotoGalleryFragment 还 在 活动 的 时 候 接 收发 
过 来 的 intent。 在 配置 文件 中 声明 的 standalone receiver 总 在 接收 intent， 而 且 它 还 要 知道 
PhotoGalleryFragment 的 状态 (这 是 个 难点 )。 

使 用 动态 broadcast receiver 能 解决 问题 。 动 态 broadcast receiver 是 在 代码 中 而 不 是 在 配置 文 付 
中 完成 登记 声明 的 。 要 在 代码 中 登记 ， 可 调用 registerReceiver(BroadcastReceiver， 
IntentFilter) 方 法 ; 取消 登记 时 ， 则 调用 unregisterReceiver(BroadcastReceiver) 方 法 。 
receiver 自 身 通常 被 定义 为 一 个 内 部 类 实例 ， 如 同一 个 按钮 点 击 监听 器 。 然 而 ,在 register- 
Receiver(.,,) 和 unregisterReceiver(BroadcastReceiver) 方 法 中 ， 你 要 的 是 同一 个 实例 ， 
因此 需要 将 receivex 研 值 给 给 一 个 实例 变量 

新 建 一 个 VisibleFragment 抽 象 类 ， 继承 Fragment 类 ， 如 代码 清单 29-7 所 示 。 该 类 是 一 个 
隐藏 前 台 通知 的 通用 型 fagment。( 在 第 30 章 ， 你 还 会 编写 一 个 类 似 的 fragment。 ) 
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代码 清单 29-7 VisibleFragment 自 己 的 receiver (VisibleFragment.java ) 


public abstract class VisibleFragment extends Fragment { 
private static final String TAG = "VisibleFragment"; 


@Override 

public void onStart() { 
super.onStart(); 
IntentFilter filter = new IntentFilter(PollService.ACTION SHOW_ NOTIFICATION); 
getActivity().registerReceiver(mOnShowNotification, filter); 
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} 


@Override 
public void onStop() { 
super.onStop(); 
getActivity() .unregisterReceiver(mOnShowNotification); 


private BroadcastReceiver mOnShowNotification = new BroadcastReceiver() { 
@Override 
public void onReceive(Context context, Intent intent) { 
Toast .makeText (getActivity(), 
"Got a broadcast:" + intent.getAction(), 
Toast .LENGTH_LONG) 
.Show(); 


}; 


意 , 要 传人 一 个 IntentFilter, 必须 先 以 代码 的 方式 创建 它 。 这 里 创建 的 IntentFilter 
同 以 下 XML 文件 定义 的 filter 是 一 样 的 : 


<intent-filter> 
<action android:name="com.bignerdranch.android.photogallery.SHOW NOTIFICATION" /> 
</intent-filter> 


任何 使 用 XML 定 义 的 IntentFilter 均 能 以 代码 的 方式 定义 。 要 在 代码 中 配置 IntentFilter， 
可 以 直接 调用 addCategory(String) 、addAction(String) 和 addDataPath(String) 等 方法 。 
使 用 动态 登记 的 broadcast receiver 时 ， 要 记得 事后 清理 。 通 常 ， 如 果 在 生命 周期 启动 方法 中 
登记 了 一 个 receiver ， 就 应 在 相应 的 停止 方法 中 调用 On .UnregisterReceiver 
(BroadcastReceiver) 方 法 。 这 里 ， 我 们 在 onStart() 方 法 里 登记 ， 在 onStop() 方 法 里 撤销 登 
记 。 同 样 ， 如 果 在 onCreate(,. ,) 方 法 里 登记 ， 就 应 在 onDestroy() 里 撤销 登记 。 

(顺便 要 说 的 是 ， 我 们 应 注意 在 保留 fagment 中 的 onCreate ( , onDestroyt) () 方 法 的 使 用 。 
设备 旋转 时 , onCreate(..,) 和 onDestroy() 方法 中 的 getActivity( ) 方 法 会 返回 不 同 的 值 。 因此 ， 
如 果 想 在 Fragment . ee ETIE) 和 Fragment .onDestroy( ) 方 法 中 实现 登记 或 撤销 登记 , 应 
改 用 getActivity() .getAppLicationContext () 方 法 。) 

接 下 来 , 修改 PhotoGaLteryFragment 类 , 转 而 继承 新 的 VisibteFragment , 如 代码 清单 29-8 
所 示 。 


代码 清单 29-8 设置 fagment 为 可 见 (PhotoGalleryFragment,java ) 
public class PhotoGalleryFragment extends Fragment VisibLeFragment { 
















































































运行 PhotoGallery 应 用 。 多 次 开关 后 台 结 果 检 查 服 务 ， 可 看 到 toast 提 示 消 息 ， 如 图 29-4 所 示 。 
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图 29-4 ”验证 broadcast 的 存在 


29.3.3 ”使 用 私有 权限 限制 broadcast 


使 用 动态 broadcast receiver 存 在 一 个 问题 , 即 系统 中 的 任何 应 用 均 可 监听 并 触发 你 的 receiver。 
通常 来 讲 ， 都 不 是 你 想 要 的 。 

不 要 担心 ， 有 多 种 方式 可 以 阻止 未 授权 应 用 部 和 你 的 私人 领域 。 一 种 办 法 是 在 manifest 配 置 
文件 里 给 receiver 标 签 添加 一 个 android:exported="false" 属 性 ， 声 明 它 仅 限 应 用 内 部 使 用 。 
这 样 ， 系 统 中 的 其 他 应 用 就 再 也 无 法 接触 到 该 receiver 了 。 

另外 ,也 可 创建 自己 的 使 用 权限 。 这 需要 在 AndroidManifest,xml 中 添加 一 个 permission 标 签 。 
这 是 PhotoGallery 应 用 要 用 到 的 办 法 。 

在 AndroidManifest.xml 配 置 文件 中 ， 声 明 并 获取 自己 的 使 用 权限 ， 如 代码 清单 29-9 所 示 。 


代码 清单 29-9 添加 私有 权限 ( AndroidManifest.xml ) 


<manifest ...> 


























<permission android:name="com.bignerdranch.android.photogallery .PRIVATE" 
android:protectionLevel="signature" /> 


<uses-permission android:name="android.permission.INTERNET" /> 

<uses-permission android:name="android.permission.ACCESS NETWORK STATE" /> 
<uses-permission android:name="android.permission.RECEIVE BOOT COMPLETED" /> 
<uses-permission android:name="com.bignerdranch.android.photogallery .PRIVATE" /> 


</manifest> 
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以 上 代码 中 ， 你 使 用 protection level 签 名 定义 了 自己 的 定制 权限 。 稍 后 ， 还 会 学 习 到 更 多 有 
关 protection level 的 知识 。 如 同 前 面 用 过 的 intent 操 作 、 类 别 和 系统 权限 ， 权 限 本 身 只 是 一 行 简单 
的 字符 串 。 即 使 是 自 定义 的 权限 ， 也 必须 在 使 用 这 个 权限 前 获取 它 ， 这 是 规则 。 

注意 代码 中 的 加 亮 常 量 ， 这 样 的 字符 串 需 要 在 三 个 地 方 出 现 ， 并 且 要 保证 完全 一 致 。 因 此 ， 
最 好 使 用 复制 粘贴 功能 ， 而 不 是 手动 输入 。 

现在 , 为 使 用 权限 , 在 代码 中 定义 一 个 对 应 常量 , 然后 将 其 传人 sendBroadcast(...) 方 法 ， 
如 代码 清单 29-10 所 示 。 


代码 清单 29-10 发送 带 有 权限 的 broadcast (PollService.java ) 


public class PollService extends IntentService { 





























public static final String ACTION SHOW NOTIFICATION = 


"com.bignerdranch.android.photogallery.SHOW NOTIFICATION"; 
public static final String PERM PRIVATE = 
"com.bignerdranch.android.photogallery .PRIVATE"; 


public static Intent newIntent(Context context) { 
return new Intent(context, PollService.class); 


} 

@Override 

protected void onHandleIntent(Intent intent) { 
String resultId = items.get(0).getId(); 


if (resultId.equals(lastResultId)) { 


Log.i(TAG, "Got an old result: " + resultId); 
} else { 


notificationManager.notify(0, notification); 29 


sendBroadcast(new Intent(ACTION SHOW_NOTIFICATION) ，PERM_PRIVATE ) ; 





} 


QueryPreferences.setLastResultId(this, result1d); 


} 

要 使 用 权限 , 需 将 其 作为 参数 传人 sendBroadcast(...) 方 法 。 有 了 这 个 权限 ,所 有 应 用 都 必须 
使 用 同样 的 权限 才能 接收 你 发 送 的 intent。 

该 如 何 保护 你 的 broadcastreceiver 呢 ? 其 他 应 用 可 通过 创建 自己 的 broadcast intent 来 触发 它 。 
同样 ， 在 registerReceiver(...) 方 法 中 传 入 自 定义 权限 就 能 解决 该 问题 ， 如 代码 清单 29-11 
所 示 。 


代码 清单 29-11 broadcast receiver 的 使 用 权限 ( VisibleFragment.java ) 


public abstract class VisibleFragment extends Fragment { 





@Override 
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} 


现在 ， 只 有 photoGallery 应 月 

深入 学 习 安 全 级 别 

自 定义 权限 必须 指定 android:protectionLevel 属 性 值 Android 根 据 protectionLevel 属 
性 值 确定 自 定义 权限 的 使 用 方式 。 在 PhotoGallery 应 用 中 ， 我 们 使 用 的 protectionLevel 是 
signature。 

signature 安 全 级 别 表明 ， 如 果 其 他 应 
相同 的 key 做 签名 认证 。 对 于 仅 限 应 i 选择 
然 其 他 开发 者 没有 相同 的 key， 自 然 也 就 


public void onStart() { 
super.onStart(); 
IntentFilter filter = new IntentFilter(PollService.ACTION SHOW NOTIFICATION); 
getActivity().registerReceiver(mOnShowNotification, 
PollService.PERM PRIVATE, null); 








来 还 可 用 于 你 开发 的 其 他 应 用 中 。 





表 29-1 





月 才能 够 触发 目标 receiver 了 。 
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于 系统 镜像 内 应 用 间 的 通信 。 权 限 授予 时 ，: 


29.3.4 ”使 用 有 序 broadcast 收发 数据 


现在 ， 


所 示 。 


Android 系 统 镜像 





























否则 ， 系 统 会 拒绝 授权 。 
各 ， 则 只 
， 它 用 来 阻止 其 他 应 
监听 它们 的 其 他 应 
P 的 所 有 包 授 本 
户 。 开 发 人 员 一 般 不 会 用 到 它 


有 签署 了 同样 
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， 你 的 任务 是 保证 动态 登记 的 receiver 总 是 先 于 其 他 receiver 接 收 到 PollService. 
ACTI A FICATION broadcast。 然 后 ， 还 要 修改 这 个 broadcast， 
虽然 可 以 发 送 个 人 私有 的 broadcast 了 ， 但 目前 还 只 是 发 而 不 收 的 单 向 通信 ， 如 图 29-5 


制止 通知 消息 的 发 布 。 
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PollService 


Receiver #1 Receiver #2 
1 
1 1 1 


1 onReceive(Context,Intent) «| onReceive(Context,Intent) 
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图 29-5 ”普通 broadcast intent 


这 是 因为 ,普通 broadcast intent 只 是 概念 上 同时 被 所 有 人 接收 。 而 事实 上 ，onReceive(...) 
方法 是 在 主线 程 上 调用 的 ， 所 以 各 个 receiver 并 没有 同步 并 发 运行 。 因 而 ， 不 可 能 指望 它们 按照 
某 种 顺序 依次 运行 ， 也 不 知道 它们 什么 时 候 全 部 结束 运行 。 结 果 就 是 ， 无 论 是 broadcast receiver 
之 间 要 通信 ， 还 是 intent 发 送 者 要 从 receiver 接 收 反 馈 信 息 ， 处 理 起 来 都 很 困难 。 

不 过 ， 我 们 可 以 使 用 有 序 broadcast intent 来 实现 双向 通信 (如 图 29-6 所 示 )。 有 序 broadcast 允 
许多 个 broadcast receiver 依 序 处 理 broadcast intent。 另 外 ， 通 过 传人 一 个 名 为 result receiver 的 特别 
broadcast receiver ， 有 序 broadcast 还 支持 让 broadcast 发 送 者 接收 broadcast 接 收 者 的 返回 结果 。 
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图 29-6 ”有 序 broadcast intent 


从 接收 方 来 看 , 这 看 上 去 与 一 般 broadcast 没 什么 不 同 。 然而 , 我 们 却 因此 获得 了 特别 的 工具 : 
一 套 改变 receiver 返 回 值 的 方法 。 这 里 ， 我 们 需要 取消 通知 信息 。 这 很 简单 ， 使 用 一 个 简单 的 整 
型 结果 码 ， 将 此 要 求 告诉 信息 发 送 者 就 可 以 了 。 稍 后 ， 我 们 会 使 用 setResultCode (int) 方 法 设 
置 一 个 Activity. RESULT _CANCELED 结 果 码 。 

修改 VisibleFragment 类 ， 告 诉 SHOW_NOTIFICATION 的 发 送 者 应 该 如 何 处 置 通知 消息 ， 如 
代码 清单 29-12 所 示 。 这 个 信息 也 会 发 送 给 接收 链 中 的 所 有 broadcast receiver。 


代码 清单 29-12 ”返回 一 个 简单 结果 码 ( VisibleFragment.java ) 


public abstract class VisibleFragment extends Fragment { 
private static final String TAG = "VisibleFragment"; 
































486 第 29 章 broadcast intent 





private BroadcastReceiver mOnShowNotification = new BroadcastReceiver() { 
@Override 
public void onReceive(Context context, Intent intent) { 


I keText (getActivity( 


Teast.LENGTH_LONG} 
=Shew(O} 
// If we receive this, we're visible, so cancel 
// the notification 
Log.i(TAG, "canceling notification"); 
setResultCode(Activity.RESULT CANCELED); 


} 


我 们 只 需要 YES 或 NO 指示 ， 因 此 使 用 int 结 果 码 就 行 。 如 需 返 回 更 多 复杂 数据 ， 可 调用 
setResultData(String) 或 setResultExtras (Bundle) 方 法 。 如 需 设 置 所 有 三 个 参数 值 ， 那 就 
调用 setResult(int，String，Bundle) 方 法 。 设 定 返 回 值 后 ， 每 个 后 续 接收 者 均 可 看 到 或 修 
改 它 们 。 

为 了 证 以 上 方法 发 挥 作用 ，broadcast 必 须 有 序 。 在 PoLLService 类 中 ， 编 写 一 个 可 发 送 有 序 
broadcast 的 新 方法 ， 如 代码 清单 29-13 所 示 。 该 方法 打包 一 个 Notification 调 用 ， 然 后 以 一 个 
broadcast 发 出 。 在 onHandleIntent(.,,) 方 法 中 ， 删 除 原来 直接 发 布 通知 给 Notification- 
Manager 的 代码 ， 调 用 这 个 新 方法 发 ! bp— 一 个 有 序 broadcast。 


代码 清单 29-13 ”发 送 有 序 broadcast ( PollService.java ) 


public static final String PERM PRIVATE = 
"com.bignerdranch.android.photogallery .PRIVATE"; 

public static final String REQUEST_ CODE = "REQUEST_CODE"; 

public static final String NOTIFICATION = "NOTIFICATION"; 






































@Override 
protected void onHandleIntent(Intent intent) { 
String resultId = items.get(0).getId(); 
if (resultId.equals(lastResultId)) { 
Log.i(TAG, "Got an old result: " + result1Id); 


} else { 
Log.i(TAG, "Got a new resuLt: " + resultId); 


Notification notification = ...; 


es i _ 
Nobsfreatronnenege rt onbat hot-tea ennanager 
1 Ne 0 2 Es 出 ot I ) 


sendBroadcast(new Intent(ACTION SHOW_NOTIFICATION), PERM_ PRIVATE); 
showBackgroundNotification(0, notification); 
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QueryPreferences.setLastResultId(this, result1d); 
} 


private void showBackgroundNotification(int requestCode, Notification notification) { 
Intent i = new Intent(ACTION SHOW_ NOTIFICATION); 
i.putExtra(REQUEST CODE, requestCode); 
i.putExtra(NOTIFICATION, notification); 
sendOrderedBroadcast(i, PERM PRIVATE, null, null, 
Activity .RESULT OK, null, null); 
} 


除了 在 sendBroadcast (Intent,String) 方 法 中 使 用 的 两 个 参数 外 ，Context. sendOrdered- 
Broadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle) 方 法 
还 有 另外 五 个 参数 ， 依 次 为 : 一 个 result receiver， 一 个 支持 result receiver 运 行 的 HandLer ， 结 果 
代码 初始 值 ， 结 果 数 据 以 及 有 序 broadcast 的 结果 附加 内 容 。 

result receiver 比 较 特 殊 ， 只 有 在 所 有 有 序 broadcast intent 接 收 者 结束 运行 后 ， 它 才 开 始 运行 。 

然 有 时 也 能 使 用 result Teceiver 接 收 broadcast 和 发 布 通 知 对 象 ， 但 此 处 行 不 通 。 目 标 broadcast 
intent 通 常 是 在 PollService 对 象 消亡 之 前 发 出 的 , 这 意味 着 broadcast receiver 很 可 能 也 不 存在 了 。 

因此 ， 最终 的 broadcast receiver 应 该 是 个 standalone receiver。 而 且 , 无 论 如 何 都 要 保证 它 在 其 
他 动态 登记 的 receiver 之 后 运行 。 

首先 , 新 建 一 个 NotificationReceiver 类 , 继承 BroadcastReceiver 类 , 如 代码 清单 29-14 
所 示 。 


代码 清单 29-14 ”实现 result receiver ( NotificationReceiverjava ) 


public class NotificationReceiver extends BroadcastReceiver { 
private static final String TAG = "NotificationReceiver"; 












































二 


















































并 











@Override 
public void onReceive(Context c, Intent i) { 
Log.i(TAG, "received result: " + getResultCode()); 
if (getResultCode() != Activity.RESULT OK) { 
// A foreground activity cancelled the broadcast 
return; 


} 


int requestCode = i.getIntExtra(PollService.REQUEST CODE, 0); 
Notification notification = (Notification) 
i.getParcelableExtra(PollService.NOTIFICATION); 


NotificationManagerCompat notificationManager = 
NotificationManagerCompat.from(c); 
notificationManager.notify(requestCode, notification); 


} 


然后 , 登记 这 个 新 建 的 receiver 并 赋予 它 优先 级 。 为 保证 NotificationReceiver 最 后 一 个 接 
收 目标 broadcast ( 这 样 ， 它 就 知道 该 不 该 向 NotificationManager 发 出 通知 )， 需 要 为 它 设 置 一 
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个 低 优先 级 ,要 让 它 最 后 一 个 运行 ,设置 其 优先 级 值 为 -999, 这 是 用 户 能 定义 的 最 低 优先 级 ( -1000 
及 以 下 值 是 系统 保留 值 )。 

另外 ， 既 然 NotificationReceiver 仅 限 PhotoGallery 应 用 内 部 使 用 ， 还 需 设 置 一 个 
android:exported="false" 属 性 值 ， 以 确证 外 部 应 用 看 不 到 它 ， 如 代码 清单 29-15 所 示 。 








代码 清单 29-15 “登记 notification receiver ( AndroidManifest.xml ) 


<receiver android:name=".StartupReceiver"> 
<intent-filter> 
<action android:name="android.intent.action.BOOT COMPLETED" /> 
</intent-filter> 
</receiver> 
<receiver android:name=" .NotificationReceiver" 
android:exported="false"> 
<intent-filter android:priority="-999"> 
<action 
android:name="com.bignerdranch.android.photogallery .SHOW NOTIFICATION" /> 
</intent-filter> 
</receiver> 


运行 PhotoGallery 应 用 ,多 次 切换 后 台 polling 状 态 。 可 以 看 到 ,应 用 开 着 的 时 候 , 通知 信息 不 
会 出 现 了 。( 为 避免 傻 等 15 分 钟 ， 可 再 次 将 PollService.POLL INTERVAL MS 的 时 间 间 隔 设 置 为 
60 秒 。) 


29.4 ”receiver 与 长 时 运行 任务 


如 不 愿 受 制 于 主线 程 ， 希望 用 broadcast intent 和 触发 一 个 长 时 运行 任务 ， 该 怎么 做 呢 ? 

有 两 种 方法 可 以 选择 。 第 一 种 方法 是 将 任务 交 给 服务 去 处 理 ， 然 后 通过 broadcast receiver 瞬 
时 启动 服务 。 这 是 我 们 首 推 的 方式 。 服 务 可 以 一 直 运 行 ， 直 到 完成 要 处 理 的 任务 。 服 务 还 能 将 请 
求 放 在 队列 中 ， 然 后 依次 处 理 ， 或 按 其 自 认 为 合适 的 方式 管理 全 部 请 求 。 

第 二 种 方法 是 使 用 BroadcastReceiver.goAsync()。 该 方法 返回 一 个 BroadcastReceiver. 
PendingResult 对 象 ， 随 后 可 使 用 该 对 象 提供 结果 。 因 此 ， 可 将 PendingResult 交 给 一 个 
AsyncTask 去 执行 长 时 任务 ， 然 后 再 调用 PendingResult 的 方法 响应 broadcast。 

goAsync ( ) 方 法 的 弊端 是 不 够 灵活 。 我 们 仍 需 快 速 响应 broadcast ( 10 秒 内 ), 并 且 与 使 用 服务 
相 比 ， 没 多 少 架构 模式 好 选 了 。 

当然 ，goAsync ( ) 方 法 也 有 个 明显 的 优势 : 可 调用 该 方法 设置 有 序 broadcast 的 结果 。 如 果 别 
无 选择 ， 真 的 要 使 用 ， 应 注意 控制 尽快 完事 。 


29.5 深入 学 习 : 本 地 事件 


broadcast intent 可 实现 系统 内 全 局 性 的 消息 传递 。 如 果 仅 需要 应 用 进程 内 的 消息 事件 广播 ， 
该 怎么 做 呢 ?” 答 案 是 使 用 事件 总 线 ( event bus )。 
事件 总 线 的 设计 思路 就 是 , 提供 一 个 应 用 内 的 部 件 可 以 订阅 的 共享 总 线 或 数据 流 。 
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发 布 到 总 线 上 ， 各 订阅 部 件 就 会 被 激活 并 执行 相应 的 回调 代码 。 
greenrobot 出 品 的 EventBus 是 目前 广为人知 的 一 个 第 三 方 事件 总 线 库 。 其 他 常用 的 导 
库 还 有 Square 的 Otto。 或 者 也 可 以 使 用 RxJava Subject 和 0bservable 来 模拟 事件 总 线 。 
为 实现 在 应 用 内 发 送 broadcast intent，Android 自 己 也 提供 了 一 个 叫 作 LocalBroadcast- 
Manager 的 广播 管理 类 。 不 过 ， 两 相 比 较 ， 还 是 上 述 第 三 方 类 库 用 起 来 更 为 灵活 和 方便 。 











件 总 线 


ey 

















29.5.1 使 用 EventBus 


要 在 应 用 中 使 用 EventBus， 首 先 需 要 在 项 目 中 添加 依赖 库 。 然 后 ， 就 可 以 定义 事件 类 了 ( 如 
果 需 要 传送 数据 ， 可 以 向 事件 里 添加 数据 字段 ): 

public class NewFriendAddedEvent { } 

在 应 用 的 任何 地 方 ， 都 可 以 把 消息 事件 发 布 到 总 线 上 : 


EventBus eventBus = EventBus .getDefautLt () ; 
eventBus .post(new NewFriendAddedEvent () ) ; 


在 总 线 上 登记 监听 ， 应 用 的 其 他 部 分 也 可 以 订阅 接收 事件 消息 。 通 常 ，activity 或 fagment 的 
登记 和 撤销 登记 都 是 在 相应 的 生命 周期 方法 中 处 理 的 ， 如 onStart(...) 和 onStop(...)。 


// In some fragment or activity... 
private EventBus mEventBus; 




















@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
mEventBus = EventBus.getDefault(); 

} 





@Override 

public void onStart() { 
super.onStart(); 
mEventBus.register(this); 


@Override 

public void onStop() { 
super.onStop(); 
mEventBus .unregister(this) ; 


} 

有 订阅 的 事件 消息 发 布 时 ,可 实施 一 个 方法 , 传人 合适 的 事件 类 型 并 添加 @Subscribe 注 解 ， 
让 订阅 者 作出 响应 。 如 果 使 用 不 带 参 数 的 @Subscribe 注 解 ， 事件 消息 来 自 哪个 线程 ， 就 在 哪个 
线程 上 处 理 。 如 果 使 用 @Subscribe(threadMode = ThreadMode .MAIN) ， 可 确保 事件 在 主线 程 
上 处 理 ， 哪 怕 它 碰巧 来 自 后 台 线 程 。 


// In some registered component, like a fragment or activity... 

@Subscribe(threadMode = ThreadMode .MAIN) 

public void onNewFriend Added (NewFriendAddedEvent event){ 
Friend newFriend = event.getFriend!(); 
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// Update the UI or do something in response to event... 


29.5.2 ”使 用 RxJava 
RxJava 也 能 用 来 实现 事件 广播 机 制 。RxJava 











库 可 用 来 开发 reactive 风 格 的 Java 人 代码。 上述 








reactive 概 念 有 深 广 的 含义 ,不 在 本 书 讨论 之 列 。 简 而 言 之 ,有 了 RxJava， 就 可 以 发 布 和 订阅 各 类 








事件 ， 并 且 还 有 很 多 通用 工具 用 来 管理 这 些 事件 。 
所 以 ， 你 可 以 创建 一 个 叫 Subject 的 对 象 ， 然 














件 。 


地 





后 发 布 事件 给 它 以 及 在 其 上 订阅 习 





Subject<0bject, Object> eventBus = new SerializedSubject<>(PublishSubject.create()); 


可 以 像 这 样 发 布 事件 给 它 


Friend someNewFriend = ...; 





NewFriendAddedEvent event = new NewFriendAddedEvent(someNewFriend); 


eventBus .onNext(event ) ; 
并 且 在 其 上 订阅 事件 : 


eventBus .subscribe(new Action1l<0bject>() { 
@Override 
public void call(Object event) { 





mn 





if (event instanceof NewFriendAddedEvent) { 
Friend newFriend = ((NewFriendAddedEvent)event).getFriend!(); 


// Update the UI 


} 
}) 


RxJava 解 决 方案 的 优势 在 于 , eventBus 现 在 也 是 个 0bservable 对 象 (代表 RxJava 的 事件 流 ) 
了 。 这 就 意味 着 RxJava 的 各 种 事件 管理 工具 都 可 以 为 你 所 用 了 。 是 不 是 愈 发 感 兴趣 了 ? 去 看 看 
RxJava 的 项 目 wiki 主页 吧 : github.com/ReactiveX/RxJava/wiki 。 












































29.6 ”深入 学 习 : 探测 ffagment 的 状态 


本 章 , 在 实现 PhotoGallery 应 用 的 通知 功能 时 ， 





我 们 使 用 了 全 局 性 的 broadcast 机 制 。broadcast 














虽然 是 全 局 的 ， 但 利用 定制 权限 ， 我 们 实现 限定 broadcast intent 只 能 在 应 用 内 接收 。 这 就 不 免 让 











人 疑惑 :“ 既 然 要 限制 ， 为 什么 还 要 使 用 全 局 机 制 ? 使 用 本 地 broadcast 机 制 不 是 更 好 吗 ? ” 





这 是 因为 有 个 难题 要 解决 : 如 何 判断 PhotoGa 


LLeryFragment 的 活动 状态 。 最 终 ， 利 用 有 序 


broadcast、standalone receiver 以 及 动态 登记 的 receiver， 问 题 总 算 解 决 了 。 虽 然 没 那么 干净 利落 ， 





但 这 是 Android 目 前 能 提供 的 最 好 解决 方案 。 























更 具体 来 讲 ， 不 用 本 地 broadcast 机 制 ， 就 是 因为 LocatBroadcastManager 既 无 法 处 理 
PhotoGallery 应 用 里 的 这 种 broadcast 通 知 ， 也 无 法 知晓 fragment 的 状态 。 如 果 继 续 深究 ， 原 因 不 外 





乎 两 点 。 











首先 ，LocalBroadcastManager 不 支持 有 序 broadcast ( 虽然 它 有 个 sendBroadcastSync 
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(Intent intent) 方 法 ,但 依然 不 灵 )， 而 在 PhotoGallery 应 用 中 ， 不 使 用 有 序 broadcast， 就 无 法 
控制 NotificationReceiver 最 后 一 个 运行 。 

其 次 ，sendBroadcastSync(Intent intent) 方 法 不 支持 在 独立 线程 上 发 送 和 接收 
broadcast 。 而 在 PhotoGallery 应 用 中 ， 需 要 在 后 台 线 程 上 发 送 broadcast ( 使 用 PollService. 
onHandleIntent(...) 方 法 )， 在 主线 程 上 接收 intent ( 在 主线 程 上 的 onStart(...) 方 法 中 , 使 
用 PhotoGalleryFragment 登 记 的 动态 receiver )。 

撰写 本 书 时 ， 关 于 LocalBroadcastManager 究 况 是 如 何 处 理 线程 上 的 broadcast 投 递 的 ， 
Android 还 没有 确切 的 说 明 。 但 经 验 告 诉 我 们 ， 它 是 有 规律 可 循 的 。 例 如 ， 如 果 从 后 台 线 程 调用 
sendBroadcastSync(...)， 所 有 的 pending broadcast 都 会 在 后 台 线 程 上 涌 出 ， 不 管 是 不 是 来 自 

当然 ，LocalBroadcastManager 也 不 是 一 无 是 处 ， 只 不 过 不 适合 解决 本 章 的 问题 而 已 。 










































































从 Flickr 下 载 的 图 片 都 有 其 关联 网 页 。 本 章 ， 我 们 继续 升级 PhotoGallery 应 用 ， 让 用 户 点 击 图 





片 就 能 看 到 它 的 Flickr 网 页 。 我 们 会 以 两 种 不 同 的 方式 整合 网 页 内 容 ， 完 成 后 的 效 呈 
































示 : 左边 是 使 用 浏览 器 应 用 ， 右 边 是 使 用 webview 在 应 用 中 显示 网 页 内 容 。 





PhotoGallery 
Flickr 











flickr Explore Nearby Search Sign In flickr 


@ NASA on The Commons Open in App ® 


ialist (MS) Peter J.K. Wisoff (bottom), 
obility Unit (EMU), work: 


Le 口 





图 30-1 ”以 两 种 方式 呈现 Web 内 容 


30.1 最 后 一 段 Flickr 数据 


过 中 





图 30-1 所 


无 论 哪 种 方式 ， 都 需要 取得 图 片 的 Flickr 网 页 URL。 如 果 查 看 下 载 图 片 的 JSON 文 件 ， 可 看 到 











图 片 的 网 页 地 址 并 不 包含 在 内 。 


"photos": { 


"photo": [ 
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"id": "9452133594"， 
"owner": "44494372GN05 " ， 
"secret": "d6d20af93e", 
"server": "7365", 
"farm": 8, 
"title": "Low and Wisoff at Work", 
"ispublic": 1, 
"isfriend": 0， 
"isfamily": 0， 
"url s":"https://farm8.staticflickr.com/7365/9452133594 d6d20af93e m.jpg" 
2 
] 
}, 
"stat": "ok" 
} 


因此 ， 你 想当然 地 认为 需要 编码 获取 更 多 JSON 内 容 才 行 。 实 际 上 ， 并 不 是 这 样 的 。 访 问 
www.flickr.com/services/api/misc.urls.html 查 看 Flickr 官 方 文档 的 Web Page URLs 部 分 可 知 ， 可 按 以 
下 格式 创建 单个 图 片 的 URL: 


http://www.flickr.com/photos/uvuser-id/photo-id 


这 里 的 photo- id 即 JSON 数 据 里 的 id 属性 值 。 该 值 已 保存 在 GaLLeryItem 类 的 mId 属 性 中 。 
那么 user-id 呢 ? 继续 查阅 Flickr 文 档 可 知 ，JSON 文 件 的 owner 属 性 值 就 是 用 户 ID。 因 此 ， 只 需 
从 JSON 文 件 解析 出 owner 属 性 值 ， 即 可 创建 图 片 的 完整 URL: 


http://www.flickr.com/photos/owner/id 


在 GalleryItem 中 添加 代码 清单 30-1 所 示 代 码 ， 创 建 图 片 URL。 
代码 清单 30-1 添加 创建 图 片 URL 的 代码 ( GalleryItem.java ) 


public class GalleryItem { 
private String mCaption; 
private String mId; 
private String mUrl; 
private String mOwner; 






































public void setUrl(String url) { 
mUrl = url; 


} 


public String getOwner() { 
return mOwner; 


} 


public void setOwner(String owner) { 
mOwner = owner; 


} 


public Uri getPhotoPageUri() { 
return Uri.parse("http://www.flickr.com/photos/") 


494 第 30 章 网 页 浏览 





.buiLdUpon() 
.appendPath (mOwner) 
.appendPath (mId) 
.build(); 

} 

@Override 


public String toString() { 
return mCaption; 
} 
} 


以 上 代码 新 建 了 一 个 m0wner 属 性 ， 以 及 一 个 产生 图 片 URL 的 getPhotoPageUri() 方 法 。 
现在 ， 修 改 parseItems(.,.) 方 法 ， 从 JSON 数 据 中 获取 owner 属 性 ， 如 代码 清单 30-2 所 示 。 


代码 清单 30-2 ”从 JSON 数 据 中 获取 owner 属 性 (FlickrFetchr.java ) 


public class FlickrFetchr { 











private void parseltems(List<GalleryItem> items, JSONObject jsonBody) 
throws IOException, JSONException { 


JSONObject photosjJsonObject = jsonBody.getJSONObject("photos"); 
JSONArray photoJsonArray = photosJson0bject.getJSONArray("photo" ) ; 


for (int i = 0; i < photoJsonArray.Length(); i++) { 
JSONObject photoJsonObject = photoJsonArray.getJSONObject(i); 


GalleryItem item = new GalleryIltem(); 
item.setId(photoJjsonObject.getString("id")); 
item.setCaption(photoJsonObject.getString("title")); 


if (!photoJson0bject.has("urL s")) { 
continue; 


item.setUrl (photoJsonObject.getString("url s")); 
item.setOwner(photoJsonObject.getString("owner")); 
items.add(item); 


} 
非常 简单 ， 获 取 图 片 网 页 URL 的 任务 就 完成 了 。 


30.2 简单 方式 : 隐 式 intent 


首先 使 用 隐 式 intent 这 个 老 朋 友 来 访问 图 片 URL。 隐 式 intent 可 启动 浏览 器 ， 并 在 其 中 打开 图 
片 URL 指 问 的 网 页 。 

首先 ， 监 听 RecycterVview 显示 项 的 点 击 事件 。 更 新 PhotoGaLLeryFragment 类 的 
PhotoHoLtder， 实 现 一 个 可 以 发 送 隐 式 intent 的 事件 监听 方法 ， 如 代码 清单 30-3 所 示 。 
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代码 清单 30-3 ”通过 隐 式 intent 实 现 网 页 浏览 (PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends VisibleFragment { 


private class PhotoHolder extends RecyclerView.ViewHolder 
impLements View.OnClickListener { 
private ImageView mItemImageView; 
private GalleryItem mGalleryItenm; 


public PhotoHolder(View itemView) { 
super (itemView); 


mItemImageView = (ImageView) itemView.findViewById(R.id.item image view); 
itemView.setOnClickListener(this); 
} 


public void bindDrawable(Drawable drawable) { 
mItemImageView.setImageDrawable(drawable); 


} 


public void bindGalleryItem(GalleryItem galleryItem) { 
mGalleryItem = galleryItenm; 


} 


@Override 

public void onClick(View v) { 
Intent i = new Intent(Intent.ACTION VIEW, mGalleryItem.getPhotoPageUri()); 
startActivity(i); 


} 
然后 ， 在 PhotoAdapter.onBindViewHolder(...) 方 法 中 绑 定 PhotoHolder 给 GalleryItenm,， 


如 代码 清单 30-4 所 示 。 co 


代码 清单 30-4 绑 定 GaLLeryItem (PhotoGalleryFragment.java ) 


private class PhotoAdapter extends RecyclerView.Adapter<PhotoHolder> { 





@Override 

public void onBindViewHolder(PhotoHolder photoHolder, int position) { 
GalleryItem galleryItem = mGalleryItems.get(position); 
photoHolder .bindGalleryItem(galleryItem); 
Drawable placeholder = getResources().getDrawable(R.drawable.bill up close); 
photoHolder.bindDrawable(placeholder); 
mThumbnailDownloader.queueThumbnail (photoHolder, galleryItem.getUrl()); 


} 


搞定 了 。 启 动 PhotoGallery 应 用 并 点 击 任 意图 片 。 浏 览 器 应 用 应 该 会 弹出 并 加 载 显 示 对 应 的 
图 片 网 页 (类似 图 30-1 的 左边 )。 
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30.3” 较 难 方式 : 使 用 WebView 














使 用 隐 式 intent 打 开 图 片 网 页 简单 又 高 效 。 但 是 ， 如 果 不 想 打开 独立 的 浏览 器 怎么 办 ? 

















通常 , 我们 只 想 在 activity 中 显示 网 页 内 容 ， 而 不 是 























成 的 HTML, 或 许 是 想 以 某 种 方式 限制 用 户 使 用 浏览 器 。 











打开 浏览 絮 。 这 么 做 或 许 是 想 显 示 自 己 
对 于 大 多 数 需 要 帮助 文档 的 应 用 ， 常 见 














的 做 法 就 是 以 网 页 的 形式 提供 帮助 文档 , 这 样 会 方便 后 





期 的 更 新 与 维护 。 打 开 浏 览 需 查看 帮助 文 





档 ， 既 不 专业 ， 又 妨碍 应 用 行为 的 定制 ， 无 法 将 网 页 整合 进 自己 的 用 户 界 面 。 
如 果 想 实现 在 应 用 里 显示 网 页 内 容 ,你 可 以 使 用 WebView 类 。 这 就 是 我 们 说 的 较 难 方式 , 但 





实际 也 没 那么 难 。( 当然 ， 相 对 隐 式 intent 来 说 ， 要 困难 





一 些 。) 


首先 ， 创 建 一 个 activity 以 及 一 个 显示 WebView 的 fragment。 依 惯例 先 定义 一 个 名 为 
fragment photo_page.xml 的 布局 文件 ,。 使 用 一 个 ConstraintLayout 作 为 一 级 组 件 ,。 在 布局 编辑 窗口 ， 
安排 一 个 WebView 作 为 ConstraintLayout 的 子 组 件 。( WebView 位 于 Containers 区 的 下 面 。) 

添加 完 WebView， 相 对 其 父 组 件 ， 为 每 一 边 添加 一 个 约束 。 具 体 如 下 : 











口 从 WebView 顶 部 到 其 父 组 件 顶 部 
口 从 WebView 底 部 到 其 父 组 件 底部 
口 从 WebView 左 边 到 其 父 组 件 左边 
口 从 WebView 右 边 到 其 父 组 件 右 边 














最 后 ， 高 和 宽 设置 为 Any Size 并 设置 所 有 的 margin 为 0。 另 外 ， 别 忘 了 给 WebVview 一 个 ID: 





web View。 

是 不 是 认为 这 里 的 ConstraintLayout 没 什么 用 ? 
~ 

已 。 


接 下 来 创建 fagment。 新 建 PhotoPageFragment 类 

















王 








现在 是 这 样 ， 稍 后 会 添加 更 多 组 件 来 


ly 


， 继承 上 一 章 的 VisibleFragment 类 。 然 


后 ,在 这 个 新 类 中 ,实例 化 布局 文件 ,引用 webview， 并 转发 从 intent 数 据 中 获取 的 URL ， 如 代码 





清单 30-5 所 示 。 


代码 清单 30-5 ”创建 网 页 浏览 fragment ( PhotoPageFragment.java ) 


public class PhotoPageFragment extends VisibLeFragment { 
private static final String ARG_URI = "photo page_url"; 


private Uri mUri; 
private WebView mWebView; 


public static PhotoPageFragment newInstance(Uri uri) { 


Bundle args = new Bundle(); 
args.putParcelable(ARG URI, uri); 


PhotoPageFragment fragment = new PhotoPageFragment(); 


fragment.setArguments (args); 
return fragment; 


} 


@Override 
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public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


mUri = getArguments().getParcelable(ARG_URI); 
} 


@Override 
public View onCreateView(LayoutInfLater inflater, ViewGroup container， 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment photo page, container, false); 


mWebView = (WebView) v.findViewById(R.id.web view); 
return v; 


} 


当前 ,PhotoPageFragment 类 还 未 完成 , 稍 后 再 来 完成 它 。 接 下 来 ,新 建 PhotoPageActivity 
托管 类 ， 继 承 SingLeFragmentActivity 类 ， 如 代码 清单 30-6 所 示 。 























代码 清单 30-6 创建 显示 网 页 的 activity ( PhotoPageActivity.java ) 
public class PhotoPageActivity extends SingleFragmentActivity { 
public static Intent newIntent(Context context, Uri photoPageUri) { 
Intent i = new Intent(context, PhotoPageActivity.class); 
i.setData(photoPageUri); 


return i; 


} 


@Override 
protected Fragment createFragment() { 
return PhotoPageFragment.newInstance(getIntent().getData()); 


} 
} 
回 到 PhotoGalleryFragment 类 中 ， 弃 用 隐 式 intent， 启 动 新 建 的 activity， 如 代码 清单 30-7 
所 示 。 


代码 清单 30-7 启动 新 建 的 activity ( PhotoGalleryFragment.java ) 


public class PhotoGalleryFragment extends VisibleFragment { 











private class PhotoHolder extends RecyclerView.ViewHolder 
implements View.OnClickListenert{ 


@Override 
public void onClick(View v) { 
Intent i = new Tntent(Intent.ACTION VIEW, mGalteryItem.getPhotopageUri() ); 
Intent i = PhotoPageActivity 
.newIntent(getActivity(), mGalleryItem.getPhotoPageUri()); 
startActivity(i); 
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最 后 ， 在 配置 文件 中 声明 新 建 的 activity， 如 代码 清单 30-8 所 示 。 
代码 清单 30-8 在 配置 文件 中 声明 activity ( AndroidManifest.xml ) 


<manifest ... > 











<application 
> 
<activity 
android:name=".PhotoGalleryActivity" 
android:label="@string/app _ name" > 
</activity> 


<activity 
android:name=" .PhotoPageActivity" /> 


<Service android:name=".PollService" /> 
</application> 
</manifest> 


运行 PhotoGallery 应 用 ， 点 击 任意 图 片 ， 可 看 到 一 个 新 的 空 activity 弹 
































LJ 
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好 了 ， 现 在 来 处 理 关 键 部 分 ， 让 fragment 发 挥 其 作用 。webVview 要 显 
三 件 事 。 

首先 是 告诉 WebView 要 打开 的 URL。 

其 次 是 启用 JavaScript。jJavaScript 默 认 是 禁用 的 。 虽 然 并 不 总 是 需要 























示 Flickr 图 片 网 页 ， 需 做 


启用 它 ， 但 Flickr 网 站 需 


要 。( 启用 JavaScript 后 ，Android Lint 会 提示 警告 信息 ( 担心 跨 网 站 的 脚本 攻击 )， 可 以 使 用 
@SuppressLint ("SetJavaScriptEnabled") 注 解 onCreateView(,..) 方 法 以 禁 I 上 Lint 的 警告 。 








最 后 , 需要 实现 一 个 WebViewClient 类 ( 用 来 响应 Webyiew 上 的 演 染 事 
所 示人 代码 。 然 后 ， 我 们 来 详细 解读 PhotoPageFragment 类 。 


代码 清单 30-9 加 载 URL ( PhotoPageFragment.java ) 


public class PhotoPageFragment extends VisibLeFragment { 





GOverride 





件 )。 添加 代码 清单 30-9 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 


Bundle savedInstanceState) { 


View v = inflater.inflate(R.layout.fragment photo page, container, false); 


mWebView = (WebView) v.findViewById(R.id.web view); 
mWebView.getSettings().setJavaScriptEnabled(true); 
mWebView. setWebViewClient (new WebViewClient() { 
mWebView,.loadUrl(mUri.toString()); 


return v; 
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} 
} 


加 载 URL 必 须 等 WebView 配 置 完成 后 进行 ， 因 此 最 后 再 执行 这 一 操作 。 在 此 之 前 ,首先 调用 
getSettings() 方 法 获得 WebSettings 实 例 ， 再 调用 WebSettings.setJavaScriptEnabled 
(true) 方 法 启用 JavaScript。 WebSettings 是 修改 WebView 配 置 的 三 种 途径 之 一 。 男 外 还 有 其 他 一 
些 可 设置 属性 ， 如 用 户 代理 字符 串 和 显示 文字 大 小 。 

然后 ,添加 一 个 WebViewClient 给 WebView。 为 什么 要 添加 ? 解释 之 前 ， 我们 先 看 看 没有 它 
会 发 生 什么 。 

载 入 一 个 新 URL 有 好 几 种 方式 : 当前 页 面 刷新 让 你 转 人 男 一 个 URL (一 个 重 定 问 ), 或 者 点 
击 一 个 链接 载 人 。 如 果 没 有 WebViewClient，WebView 会 要 求 activity 管 理 器 找 一 个 新 activity 来 载 
人 新 URL。 

这 不 是 我 们 想 要 的 。 如 果 从 手机 浏览 器 加 载 ， 许 多 网 址 (包括 Flickr 图 片 网 页 ) 会 重 定向 到 
移动 版 本 的 网 址 。 因 此 ， 发 送 一 个 隐 式 intent 启 动 其 他 浏览 器 应 用 解决 不 了 问题 。 我 们 需要 在 自 
己 应 用 里 展示 网 页 。 

所 以 ， 给 WebView 添 加 一 个 WebViewClient， 事 情 就 不 一 样 了 。 现 在 ，WebView 不 会 再 去 麻 
烦 activity 管 理 器 ， 它 会 去 找 WebViewClient。 按 照 WebViewClient 的 默认 实现 ， 它 会 说 : 
“WebView， 自 己 载 和 URL 吧 。” 这 样 ， 目 标 网 页 就 在 WebView 中 打开 了 。 

运行 应 用 ， 点 击 任意 图 片 ， 应 该 可 以 看 到 显示 对 应 图 片 的 WebView ( 类似 图 30-1 的 右边 )。 























































































































使 用 WebChromeClient 优化 WebView 显示 


既然 花 时 间 实 现 了 自己 的 WebView, 接 下 来 开始 优化 , 为 它 添加 一 个 标题 视图 和 一 个 进度 条 。 
以 视图 的 方式 打开 fragment photo page.xml， 拖 入 一 个 ProgressBar 组 件 作 为 ConstraintLayout 的 第 
二 个 子 组 件 (使 用 ProgressBar ( Horizontal ) 版 本 )),。 删除 WebView 最 上 面 的 约束 。 然 后 为 方便 使 
用 它 的 约束 handle， 设 置 其 高 度 值 为 Fixed。 

完成 后 ， 再 创建 以 下 额外 约束 。 
口 从 ProgressBar 到 其 父 组 件 的 上 ， 左 ， 右 。 
口 从 WebView 的 顶部 到 ProgressBar 的 底部 。 
接 下 来 ， 重 置 WMebView 的 高 度 为 Any Size, 设置 ProgressBar 的 高 度 为 wrap_content， 宽 度 为 
Any Size。 

最 后 ， 选 中 ProgressBar 组 件 ， 在 右边 的 属性 窗口 ， 将 visibility 和 tools visibility 分 别 设置 为 
gone 和 visible， 最 后 重 命名 其 ID 为 progress_bar。 

完成 后 的 结果 图 如 图 30-2 所 示 。 
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图 30-2 ”添加 ProgressBar 


为 使 用 ProgressBar， 还 需 使 用 WebView:WebChromeClient 的 第 二 个 回调 方法 。 如 果 说 
WebViewClient 是 响应 泻 染 事件 的 接口 ， 那 么 WebChromeClient 就 是 一 个 事件 接口 ， 用 来 响应 
那些 改变 浏览 器 中 装饰 元 素 的 事件 。 这 包括 JavaScript 警 告 信息 、 网 页 图 标 、 状 态 条 加 载 ， 以 及 当 
前 网 页 标题 的 刷新 。 

在 onCreateView(...) 方 法 中 ,编码 实现 使 用 WebChromeClient， 如 代码 清单 30-10 所 示 。 
代码 清单 30-10 ”使 用 WebChromeClient (PhotoPageFragment.java ) 


public class PhotoPageFragment extends VisibLeFragment { 














private WebView mWebView; 
private ProgressBar mProgressBar; 


@Override 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


View v = inflater.inflate(R.layout.fragment photo page, container, false); 


mProgressBar = (ProgressBar)v.findViewById(R.id.progress_bar); 
mProgressBar.setMax(100); // WebChromeClient reports in range 0-100 


mWebView = (WebView) v.findViewById(R.id.web view); 
mWebView.getSettings().setJavaScriptEnabled(true); 
mWebView.setWebChromeClient(new WebChromeClient() { 
public void onProgressChanged (WebView webView, int newProgress) { 
if (newProgress == 100) { 
mProgressBar.setVisibility (View.GONE); 
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} else{ 
mProgressBar.setVisibility(View.VISIBLE); 
mProgressBar.setProgress (newProgress); 


} 


public void onReceivedTitle(WebView webView, String title) { 
AppCompatActivity activity = (AppCompatActivity) getActivity(); 
activity.getSupportActionBar().setSubtitle(title); 


} 


}); 
mWebView.setWebViewClient (new WebViewClient()); 


mWebView.loadUrl (mUri.toString()); 
return v; 


} 

进度 条 和 标题 栏 更 新 都 有 各 自 的 回调 方法 ， 即 onProgressChanged (WebView，int) 和 
onReceivedTitle(WebView, String) 方 法 。 从 onProgressChanged (WebView,， int) 方 法 收 到 
的 网 页 加 载 进度 是 一 个 从 0 到 100 的 整数 值 。 如 果 值 是 100， 说 明 网 页 已 完成 加 载 ， 因 此 需 设 置 进 
度 条 可 见 性 为 View.GONE， 将 ProgressBar 视 图 隐藏 起 来 。 

运行 PhotoGallery 应 用 。 现 在 ， 应 看 到 类 似 图 30-3 的 应 用 画面 。 
































子 标题 PhotoGallery 
内 一 一 着 宙 24 
[一 | 一 进度 条 


Explore Nearby Search Sign In 





@ Loading 


图 30-3 ”漂亮 的 WebView 





点 击 任意 图 片 ，PhotoPageActivity 会 出 现 。 网 页 加 载 时 ， 会 出 现 进度 条 ， 工 具 栏 会 出 现 
来 自 onReceivedTittLe(..,) 方 法 的 子 标题 。 页 面 加 载 完毕 ， 进 度 条 随即 消失 。 
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30.4” 人 处理 WebView 的 设备 旋转 问题 


尝试 旋转 设备 屏幕 。 尽 管 应 用 工作 如 常 ， 但 WebView 重 新 加 载 了 网 页 。 这 是 因为 WebView 包 
含 太 多 的 数据 ,无 法 在 onSaveInstanceState(...) 方 法 内 全 部 保存 。 所 以 每 次 设备 旋转 , 它 都 
必须 从 头 开始 加 载 网 页 数据 。 

是 不 是 想到 了 PhotoPageFragment 保 留 ? 不 好 意思 , 这 里 行 不 通 。 因 为 WebView 是 视图 层级 
结构 的 一 部 分 ， 所 以 旋转 后 它 肯 定 会 销毁 并 重建 。 

对 于 一 些 类 似 的 类 ( 如 VideoView )，Android 文 档 推荐 让 activity 自 己 处 理 设备 配置 变更 。 也 
就 是 说 ， 无 需 销毁 重建 activity， 就 能 直接 调整 自己 的 视图 以 适应 新 的 屏幕 尺寸 。 这 样 ，Webview 
也 就 不 必 重 新 加 载 全 部 数据 了 。 

为 了 让 PhotoPageActivity 自 己 处 理 设备 配置 调整 , 可 在 AndroidManifest,xml 配 置 文件 中 做 
如 下 调整 ， 如 代码 清单 30-11 所 示 。 





































































































代码 清单 30-11 自己 处 理 设备 配置 更 改 ( AndroidManifest.xml ) 
<manifest ... > 
和 
android:name=".PhotoPageActivity" 
android:configChanges="keyboardHidden |orientation|screenSize" /> 
</manifest> 
android:configChanges 属 性 表明 , 如 果 因 键盘 开 或 关 、 屏 幕 方向 改变 、 屏 幕 大 小 改变 ( 也 
包括 Android 3.2 之 后 的 屏幕 方向 变化 ) 而 发 生 设 备 配置 更 改 ， 那 么 activity 应 自己 处 理 配置 更 改 。 
运行 应 用 ， 再 次 尝试 旋转 设备 ， 一 切 都 完美 了 。 
自己 处 理 配 置 更 改 的 风险 
自己 处 理 设备 配置 更 改 ， 我 们 轻松 搞定 了 webVview 的 设备 旋转 问题 。 既 然 这 么 简单 ， 为 什么 
不 全 面 推广 使 用 这 个 方法 呢 ? 实际 上 ， 事 情 没 那么 简单 ， 自 己 处 理 配 置 变 更 也 是 有 风险 的 。 
首先 ， 资 源 修饰 符 无 法 自动 工作 了 。 开 发 人 员 必 须 手 工 重 载 视 图 。 这 实际 是 非常 棘手 的 。 
其 次 ,也 是 更 重要 的 一 点 , 既然 activity 自 己 处 理 配 置 更 改 了 , 你 很 可 能 不 会 去 覆盖 Activity ， 
onSavedInstanceState(...) 方 法 存储 UI 状态 。 然 而 ， 这 依然 是 必需 的 ， 即 使 自己 处 理 设备 配 
置 更 改 也 是 一 样 。 因 为 低 内 存 情况 还 是 要 考虑 的 。( 还 记得 吗 ?activity 不 运行 的 时 候 ， 系 统 可 能 
会 销毁 并 和 暂 存 它 的 状态 ， 如 第 3 章 图 3-14 中 看 到 的 那样 。) 


30.5 ”深入 学 习 : 注入 JavaScript 对 象 


你 已 经 知道 如 何 使 用 WebViewClient 和 WebChromeClient 类 响应 发 生 在 WebView 里 的 特定 
事件 。 然而, 通过 注入 任意 JavaScript 对 象 到 WebView 本 身 包含 的 文档 中 ,还 可 以 做 到 更 多 。 打 开 
文 档 网 页 developer.android.com/reference/android/webkit/WebView.html ， 找 到 addJavascript- 
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Interface(0bject, String) 方 法 看 看 。 使 用 该 方法 ,可 注入 任意 JavaScript 对 象 到 指定 文档 中 : 


mwebView.addJavascriptInterface(new Object() { 
@JavascriptInterface 
public void send(String message) { 
Log.i(TAG, "Received message: " + message); 


} 
}, "androidObject"); 


然后 按 如 下 方式 调用 : 
<input type="button" value="In WebView!" 


onClick="sendToAndroid('In Android land')" /> 


<script type="text/javascript"> 
function sendToAndroid(message) { 
androidObject. send (message); 


} 


</script> 

上 述 代码 有 些 地 方 值得 一 说 。 首 先 ， 调 用 send (String) 方 法 时 ， 它 不 是 在 主线 程 上 ， 而 是 
在 WebView 拥 有 的 线程 上 被 调 的 。 所 以 , 要 是 有 Android UI 更 新 任务 ， 你 需要 使 用 Handler 把 控制 
传 回 给 主线 程 。 

其 次 ， 除 了 String， 其 他 好 多 数据 类 型 都 没 法 支持 。 如 果 有 其 他 复杂 数据 类 型 ， 那 只 能 转 成 
String 类 型 ， 比 如 ， 转 成 常见 的 JSON 格 式 。 使 用 者 收 到 后 ， 自 己 再 去 按 需 解析 。 

自 Jelly Bean 4.2 ( API 17 ) 开始 ， 只 有 以 @JavascriptInterface 注 解 的 公共 方法 才 会 暴露 
给 JavaScrpit。 在 这 之 前 ， 所 有 对 象 树 中 的 公共 方法 都 是 开放 访问 的 。 

这 可 能 有 风险 ， 因 为 一 些 可 能 的 问题 网 页 能 够 直接 接触 到 应 用 。 安 全 起 见 ， 要 么 自己 掌控 局 
面 ， 要 么 严格 控制 不 要 暴露 自己 的 接口 。 


30.6 深入 学 习 : WebView 升级 


基于 Chromium 开 源 项 目 , 随 KitKat 4.4( API19 ) 发 布 的 WebView 经 历 了 一 次 大 修 。 新 WebView 
使 用 了 和 Android 版 Chrome 一 样 的 泻 染 引擎 。 现 在 ， 两 者 的 页 面 外 观 和 浏览 器 行为 越 来 越 趋 于 统 
一 了 。( 然 而，WebView 并 不 具有 Android Chrome 的 全 部 特性 。 查 看 developerchrome.comy 
multidevice/webview/overview， 可 看 到 它们 的 对 照 表 。) 

转向 Chromium 给 WebView 带 来 了 一 系列 激动 人 心 的 改进 ， 比 如 支持 HTML5 和 CSS3 新 网 页 标 
准 , 一 个 全 新 的 JavaScript 引 苟 以 及 增强 的 网 页 展示 性 能 。 从 开发 者 的 角度 看 , 一 个 最 令 人 兴奋 的 
新 特性 就 是 ，WebView 终 于 支持 使 用 Chrome DevTools 进 行 远 程 调 试 了 ( 调用 WebView. 
setWebContentsDebuggingEnabled() 方 法 开启 )。 

自 Lollipop ( Android 5.0 ) 开始 ，WebView 的 Chromium 层 会 自动 从 Google Play 商店 更 新 。 等 
Android 发 布 新 系统 版 本 才能 升级 安全 补丁 或 用 上 新 功能 的 日 子 终 于 熬 到 头 了 。 对 开发 者 来 说 ， 
这 是 个 大 事件 。 

现在 ， 对 于 Nougat ( Android 7.0 )，WebVview 的 Chromium 层 又 改 为 直接 来 自 Chrome APK 安 装 
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包 。 这 变化 也 太 快 了 。 没 事 ， 无 论 如 何 ， 只 要 WebView 能 一 直 保持 更 新 ， 就 该 满足 了 。 


30.7 ”挑战 练习 : 使 用 后 退 键 浏览 历史 网 页 


注意 到 了 没有 ， 启 动 PhotoPageActivity 之 后 ， 还 可 以 在 WebView 中 点 击 跳 转 到 其 他 链接 。 
然而 ， 不管 如 何 跳 转 ， 访 问 了 多 少 个 网 页 ， 只 要 按 后 退 键 ， 就 会 立即 回 到 PhotoPageActivity。 
如 果 想 使 用 后 退 键 在 WebView 里 层 层 退 回 到 已 浏览 的 历史 网 页 呢 ? 

提示 : 首先 覆盖 后 退 键 方法 Activity .onBackPressed() ,在 该 方法 内 ,再 搭配 使 用 WebView 
的 历史 记录 浏览 方法 (WebView.canGoBack() 和 WebView.goBack() ) 实现 想 要 的 浏览 逻辑 。 如 
果 WebView 里 有 历史 浏览 记录 ， 就 回 到 前 一 个 历史 网 页 ， 否 则 调用 super.onBackPressed() 方 
法 回 到 PhotoPageActivity。 


30.8 ”挑战 练习 : 非 HTTP 链接 支持 


使 用 PhotoPageFragment 的 WebView 时 ， 你 可 能 会 遇 到 非 HITP 链 接 。 例 如 ， 本 书写 作 时 ， 
Flickr 图 片 明细 页 会 显示 一 个 Open in App 按 钮 。 如 果 点 击 它 ， 应 该 会 启动 Flickr 应 用 (已 安装 ); 
没 安装 的 话 ， 会 启动 Google Play 应 用 商店 让 用 户 选 择 安装 它 。 

然而 ， 实 际 点 击 Open in App 按 钮 ，WebView 却 显示 了 如 图 30-4 所 示 的 画面 。 





























PhotoGallery 


Webpage not available 


PhotoGallery 
Flickr 





Flickr 
Free-ImGoogleplay Webpage not available 


Close | The webpage at market://details? 
id=com.yahoo.mobile.client.android.flickr could not be 
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图 30-4 ”Open in App 错 误 














这 是 因为 WebViewCLient 总 是 让 webView 尝 试 自己 加 载 URI, 即使 是 它 不 支持 的 URI scheme。 
要 解决 这 个 问题 ， 非 HITP URI 就 要 交 给 最 合适 的 应 用 去 处 理 。 因 此 , 加 载 URI 前 ， 先 检查 它 
的 scheme， 如 果 不 是 HTTP 或 HTTPS， 就 发 送 一 个 针对 目标 URI 的 Intent.ACTION_VIEW。 








定制 视图 与 触摸 事件 








本 章 , 通过 开发 一 个 名 为 BoxDrawingView 的 定制 View 子 类 , 我 们 来 学 习 如 何 处 理 触摸 事件 。 
在 新 项 目 DragAndDraw 中 , 这 个 定制 View 会 响应 用 户 的 触摸 与 拖 动 , 在 屏幕 上 绘制 出 矩形 框 ， 如 


图 31-1 所 示 。 
Vd 7:00 
DragAndDraw 

















图 31-1 各 种 形状 大 小 的 绘制 框 








31.1 创建 DragAndDraw 项 目 


创建 DragAndDraw 新 项 目 , 最 低 SDK 版 本 选择 API 19, 新 建 空 activity 并 命名 为 DragAndD raw- 
Activity。 
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既然 SingLeFragmentActivity 可 实例 化 仅 包 含 单 个 fagment 的 布局 ， 我 们 让 DragAndD raw- 
Activity 继 承 它 。 在 Android Studio 中 , 复制 之 前 项 目的 SingleFragmentActivityjava 和 activity _ fragment. 
xml 文 件 到 DragAndDraw 项 目的 对 应 目录 中 。 

在 DragAndDrawActivityjava 中 ,修改 代码 继承 SingteFragmentActivity 类 , 并 创建 返回 一 
个 DragAndD rawFragment 对 象 〈 稍 后 会 创建 该 类 )， 如 代码 清单 31-1 所 示 。 

















代码 清单 31-1 修改 activity ( DragAndDrawActivity.java ) 
public class DragAndDrawActivity extends AppCompatActivity SingleFragmentActivity { 
@Override 


public Fragment createFragment() { 
return DragAndDrawFragment.newInstance(); 


为 准备 DragAndDrawFragment 的 布局 ， 重 命名 activity_drag_and_draw.xml 为 fragment drag_ 
and_draw.xml。 

DragAndDrawFragment 的 布局 最 终 由 BoxDrawingView 定 制 视图 组 成 。 稍 后 我 们 会 创建 这 个 
定制 视图 类 。 它 会 处 理 所 有 的 图 形 绘 制 和 触摸 事件 。 

继承 android.support.v4.app.Fragment 超 类 ， 新 建 DragAndDrawFragment 类 。 然 后 覆盖 
onCreateView(...) 方 法 , 并 在 其 中 实例 化 fragment drag and_ drawxml 布 局 , 如 代码 清单 31-2 所 示 。 


























代码 清单 31-2 创建 DragAndDrawFragment ( DragAndDrawFragment.java ) 


public class DragAndDrawFragment extends Fragment { 


public static DragAndDrawFragment newInstance() { 
return new DragAndDrawFragment () ; 


} 


@Override 
public View onCreateView(LayoutInfLater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment drag_and_ draw, container, false); 
return v; 


} 
运行 DragAndDraw 应 用 ， 确 认 运 行 效 果 如 图 31-2 所 示 。 
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VAR 7:00 
DragAndDraw 





Hello World! 








图 31-2” 带 默认 布局 的 DragAndDraw 应 用 





31.2 ”创建 定制 视图 


Android 为 开发 者 准备 了 很 多 标准 视图 与 组 件 ， 但 有 时 为 追求 独特 的 应 用 视觉 效果 ， 创 建 定 
制 视 图 不 可 避免 。 
虽然 定制 视图 很 多 ， 但 总 体 归 为 以 下 两 大 类 别 。 
口 简单 视图 。 简 单 视图 内 部 也 可 以 很 复杂 ， 之 所 以 归 为 简单 类 别 ， 是 因为 简单 视图 不 包括 
子 视图 。 简 单 视图 几乎 总 是 用 来 处 理 定制 绘制 。 
口 聚合 视图 。 聚 合 视图 由 其 他 视图 对 象 组 成 。 聚合 视 图 通常 用 来 管理 子 视图 ， 但 不 负责 处 
理 定制 绘制 。 图 形 绘制 任务 都 委托 给 了 各 个 子 视图 。 
以 下 为 创建 定制 视图 所 需 的 三 大 步 又 。 

(1) 选择 超 类 。 对 于 简单 定制 视图 而 言 ，View 是 个 空白 画布 ， 因 此 它 作为 超 类 最 常见 。 对 于 
聚合 定制 视图 ， 我 们 应 选择 合适 的 超 类 布局 ， 比 如 FrameLayout。 

(2) 继承 选 定 的 超 类 ， 和 覆盖 超 类 的 构造 方法 。 

(3) 覆盖 其 他 关键 方法 ， 以 定制 视图 行为 。 










































































创建 BoxDrawingView 视图 


BoxDrawingView 是 个 简单 视图 ， 同 时 也 是 View 的 直接 子 类 。 
以 View 为 超 类 ， 新 建 BoxDrawingView 类 。 在 BoxDrawingView.java 中 ， 添 加 两 个 构造 方法 。 


如 代码 清单 31-3 所 示 。 
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代码 清单 31-3 ”初始 的 BoxDrawingView 视 图 类 ( BoxDrawingView.java ) 
public class BoxDrawingView extends View { 
// Used when creating the view in code 
public BoxDrawingView(Context context) { 


this(context, null); 
} 


// Used when inflating the view from XML 

public BoxDrawingView(Context context, AttributeSet attrs) { 
super(context, attrs); 

} 

} 

这 里 之 所 以 添加 了 两 个 构造 方法 , 是 因为 视图 可 从 代码 或 者 布局 文件 实例 化 。 从 布局 文件 中 
实例 化 的 视图 会 收 到 一 个 AttributeSet 实 例 ， 该 实例 包含 了 XML 布 局 文件 中 指定 的 XML 属 性 。 
即使 不 打算 使 用 构造 方法 ， 按 习惯 做 法 也 应 添加 这 两 个 构造 方法 。 

有 了 定制 视图 类 ， 我 们 来 更 新 fragment drag _and_draw.xml 布 局 文件 以 使 用 它 ， 如 代码 清单 
31-4 所 示 。 




















代码 清单 31-4 在 布局 中 添加 BoxDrawingView ( fragment drag and draw.xml ) 





android:id="@+id/activity drag_and_draw” 


xmtns:android="http://schemas .android.com/apk/res/android” 





























<com.bignerdranch.android.draganddraw.BoxDrawingView 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match _ parent" 
android:layout height="match parent" /> 


注意 ， 应 给 出 BoxDrawingView 的 全 路 径 类 名 ， 这 样 布局 inflater 才 能 够 找到 它 。 布 局 inflater 
解析 布局 XML 文件 ， 并 按 视 图 定义 创建 View 实 例 。 如 果 不 给 全 路 径 类 名 ， 布 局 inflater 会 转 而 在 
android.view 和 android.widget 包 中 寻找 同名 类 。 显 然 ， 如 果 目 标 视图 类 在 其 他 包 里 ， 布 局 
inflater 就 找 不 到 ， 应 用 就 会 月 演 。 
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所 以 , 对 于 android,view 和 android.widget 包 以 外 的 定制 视图 类 , 必须 指定 它们 的 全 路 径 
类 名 。 
运行 DragAndDraw 应 用 ， 一 切 正常 的 话 ， 屏 幕 上 会 出 现 一 个 空 视 图 ， 如 图 31-3 所 示 。 


BA RA 
DragAndDraw 











图 31-3 ”未 绘制 的 BoxDrawingView 


接 下 来 ， 让 BoxDrawingView 监 听 触 摸 事 件 ， 并 实现 在 屏幕 上 绘制 矩 形 术 


31.3 ”处 理 触 摸 事 件 
监听 触摸 事件 的 一 种 方式 是 使 用 以 下 View 方 法 ， 设 置 一 个 触摸 事件 监听 器 : 


public void setOnTouchListener(View.OnTouchListener 1) 

其 工作 方式 与 setonClickListener(View.0nClickListener) 相 同 。 实 现 View.0nTouch- 
Listener 接 口 ， 供 触摸 事件 发 生 时 调用 。 

不 过 ， 由 于 定制 视图 是 View 的 子 类 ， 也 可 走 捷径 直接 覆盖 以 下 View 方 法 : 

public boolean onTouchEvent (MotionEvent event ) 

该 方法 接收 一 个 MotionEvent 类 实例 。 MotionEvent 类 可 用 来 描述 包括 位 置 和 动作 的 触摸 事 
件 。 动 作用 于 描述 事件 所 处 的 阶段 。 











TH 
O 










































































动作 常量 动作 描述 
ACTION DOWN 手指 触摸 到 屏幕 
ACTION MOVE 手指 在 屏幕 上 移动 
ACTION_UP 手指 离开 屏幕 
ACTION_CANCEL 父 视 图 拦截 了 触摸 事件 
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在 onTouchEvent ( .. . ) 实 现 方法 中 ， 可 使 用 以 下 MotionEvent 方 法 查看 动作 值 : 

public final int getAction() 

在 BoxDrawingViewjava 中 ， 添 加 一 个 日 志 tag， 然 后 实现 onTouchEvent( . . . ) 方 法 记录 可 能 
发 生 的 四 个 不 同 动作 ， 如 代码 清单 31-5 所 示 。 
代码 清单 31-5 ”实现 BoxDrawingView 视 图 类 ( BoxDrawingView.java ) 


public class BoxDrawingView extends View { 
private static final String TAG = "BoxDrawingView"; 





@Override 

public boolean onTouchEvent(MotionEvent event) { 
PointF current = new PointF(event.getX(), event.getY()); 
String action = ""; 


switch (event.getAction()) { 

case MotionEvent.ACTION DOWN: 
action = "ACTION DOWN"; 
break; 

case MotionEvent.ACTION MOVE: 
action = "ACTION MOVE"; 
break; 

case MotionEvent.ACTION_UP: 
action = "ACTION UP"; 
break; 

case MotionEvent.ACTION CANCEL: 
action = "ACTION CANCEL"; 
break; 


} 


Log.i(TAG, action + " at x=" + current.x + 
", y=" + current.y); 


return true; 


} 

注意 ，X 和 Y 坐 标 已 经 封装 到 PointF 对 象 中 。 稍 后 ， 我 们 需要 同时 传递 这 两 个 坐标 值 。 而 
Android 提 供 的 PointF 容 器 类 刚好 满足 了 这 一 需求 。 

运行 DragAndDraw 应 用 并 打开 LogCat 视 图 窗口 。 触 摸 屏幕 并 移动 手指 ,查看 BoxDrawingView 
接收 的 触摸 动作 的 X 和 Y 坐 标记 录 。 


跟踪 运动 事件 

除了 记录 坐标 ，BoxD rawingVview 主 要 用 于 在 屏幕 上 绘制 矩形 框 。 要 实现 这 一 目标 ， 有 了 几 个 
问题 需要 解决 。 

首先 ， 要 知道 定义 矩形 框 的 两 个 坐标 点 : 原始 坐标 点 (手指 的 初始 位 置 )， 当 前 坐标 点 ( 手 
指 的 当前 位 置 )。 
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其 次 , 定义 一 个 矩形 框 , 还 需 追 踪 记 录 来 自 多 个 MotionEvent 的 数据 。 这 些 数据 会 保存 在 Box 
对 象 中 。 
新 建 一 个 Box 类 ， 用 于 表示 一 个 矩形 框 的 定义 数据 ， 如 代码 清单 31-6 所 示 。 


代码 清单 31-6 ”添加 Box 类 ( Box.java) 


public class Box { 
private PointF mOrigin; 
private PointF mCurrent; 














public Box(PointF origin) { 
morigin = origin; 
mCurrent = origin; 


} 


public PointF getCurrent() { 
return mCurrent; 


} 


public void setCurrent(PointF current) { 
mCurrent = current; 


} 


public PointF getOrigin() { 
return mOrigin; 
} 
} 


用 户 触 摸 BoxDrawingView 视 图 界面 时 ， 新 Box 对 象 会 创建 并 添加 到 现 有 和 矩形 框 数 组 中 ， 如 
图 31-4 所 示 。 





BoxDrawingView 


mBoxen mCurrentBox 











br PointF mOrigin 
PointF mCurrent 
图 31-4 ”DragAndDraw 应 用 中 的 对 象 


回 到 BoxDrawingView 类 中 ， 使 用 新 Box 对 象 跟踪 绘制 状态 ， 如 代码 清单 31-7 所 示 。 
代码 清单 31-7 添加 拖 忠 生命 周期 方法 ( BoxDrawingView.java ) 


public class BoxDrawingView extends View { 
private static final String TAG = "BoxDrawingView"; 


























入 诗 - 
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private Box mCurrentBox; 
private List<Box> mBoxen = new ArrayList<>(); 
@Override 
public boolean onTouchEvent (MotionEvent event) { 
PointF current = new PointF(event.getX(), event.getY()); 
String action = ""; 
switch (event.getAction()) { 
case MotionEvent.ACTION DOWN: 
action = "ACTION DOWN"; 
// Reset drawing state 
mCurrentBox = new Box(current); 
mBoxen.add (mCurrentBox); 
break; 
case MotionEvent.ACTION MOVE: 
action = "ACTION MOVE"; 
if (mCurrentBox != nuLL) { 
mCurrentBox.setCurrent(current); 
invalidate(); 
} 
break; 
case MotionEvent.ACTION UP: 
action = "ACTION UP"; 
mCurrentBox = null; 
break; 
case MotionEvent.ACTION CANCEL: 
action = "ACTION CANCEL"; 
mCurrentBox = null; 
break; 
} 
Log.i(TAG, action + " at x=" + Current.X + 
", y=" + current.y); 
return true; 
上 
} 





任何 时 候 ， 只 要 接收 到 ACTION_DOWN 动 作 习 





mCurrentBox， 然 后 再 添加 到 和 矩形 框 数 组 中 。( 3 
幕 上 绘制 数组 中 的 全 部 Box。 ) 

用 户 手 指 在 

指 离开 屏幕 时 ， 清 空 mCurrentBox 以 结束 
们 再 也 不 会 受 任何 动作 事件 影响 了 。 

注意 ACTION_MOVE 事 件 发 生 时 调用 的 inval 
重新 绘制 自己 。 这样, 用 户 在 屏幕 上 拖 忠 时 就 
在 屏幕 上 绘 出 矩形 框 。 


到 上 






































屏幕 上 移动 时 ，mCurrentBox.mCurrent 会 得 到 更 新 。 在 了 


性 头 





和 件 ， 就 以 事件 原始 坐标 新 建 Box 对 象 并 赋值 给 
1.4 节 处 理 定制 绘制 时 ，BoxDrawingVview 会 在 屏 




















久 消 触摸 事件 或 用 户 
也 存储 在 数组 中 ,但 





它 


制 。 已 完成 的 Box 会 安全 


idate() 方 法 。 该 方法 会 强制 BoxDrawingView 
时 看 到 矩形 框 。 这 同时 也 引出 了 接 下 来 的 任务 : 
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31.4 ”onDraw(...) 方 法 内 的 图 形 绘制 


应 用 启动 后 , 所 有 视图 都 处 于 无 效 状态 。 也 就 是 说 , 视图 还 没有 绘制 到 屏幕 上 。 为 解决 这 个 问 
题 ，Android 调 用 了 顶级 View 视 图 的 draw( ) 方 法 。 这 会 引起 自 上 而 下 的 链 式 调用 反应 。 首 先 ， 视 图 
完成 自我 绘制 , 然后 是 子 视图 的 自我 绘制 , 再 然后 是 子 视图 的 子 视图 的 自我 绘制 ,如 此 调用 下 去 直 
至 继承 结构 的 末端 。 当 继承 树 中 的 所 有 视图 都 完成 自我 绘制 后 ， 最 顶级 View 视 图 也 就 生效 了 。 

为 加 入 这 种 绘制 ， 可 禾 盖 以 下 View 方 法 : 

protected void onDraw(Canvas canvas) 

前 面 ,在 onTouchEvent (MotionEvent) 方 法 中 响应 ACTION _MOVE 动 作 时 ,我 们 调用 invalidate() 
方法 再 次 让 BoxDrawingView 失 效 。 这 会 迫使 它 重新 自我 绘制 ， 并 青 次 调用 onDraw(Canvas) 方 法 。 
现在 一 起 看 看 Canvas 参 数 。Canvas 和 Paint 是 Android 系 统 的 两 大 绘制 类 。 

口 Canvas 类 拥有 我 们 需要 的 所 有 绘制 操作 。 其 方法 可 决定 绘 在 哪里 以 及 绘 什么 ,比如 线条 、 

圆 形 、 字 词 、 和 矩形 等 。 

口 Paint 类 决定 如 何 绘制 。 其 方法 可 指定 绘制 图 形 的 特征 , 例如 是 否 填 充 图 形 、 使 用 什么 字 
体 绘 制 、 线 条 是 什么 颜色 等 。 

返回 BoxDrawingView.java 中 ， 在 BoxDrawingView 的 XML 构 造 方法 中 创建 两 个 Paint 对 象 ， 
如 代码 清单 31-8 所 示 。 


代码 清单 31-8 ”创建 Paint ( BoxDrawingView.java ) 


public class BoxDrawingView extends View { 
private static final String TAG = "BoxDrawingView"; 






















































































private Box mCurrentBox; 

private List<Box> mBoxen = new ArrayList<>(); 
private Paint mBoxPaint; 

private Paint mBackgroundPaint; 


// Used when inflating the view from XML 
public BoxDrawingView(Context context, AttributeSet attrs) { 
super(context, attrs); 





// Paint the boxes a nice semitransparent red (ARGB) 
mBoxPaint = new Paint(); 
mBoxPaint.setColor (0x22ff0000); 


// Paint the background off-white 


mBackgroundPaint = new Paint(); 
mBackgroundPaint.setColor (Oxfff8efe0); 


} 
有 了 Paint 对 象 的 支持 ， 现 在 能 在 屏幕 上 绘制 矩形 框 了 ， 如 代码 清单 31-9 所 示 。 
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代码 清单 31-9 覆盖 onD raw(Canvas ) 方 法 (BoxDrawingView.java ) 


public BoxDrawingView(Context context, AttributeSet attrs) { 


} 


@Override 

protected void onDraw(Canvas canvas) { 
// Fill the background 
canvas .drawPaint (mBackgroundPaint); 


for (Box box : mBoxen) { 
float Left = Math.min(box.getOrigin().x, box.getCurrent().x); 


float right = Math.max(box.getOrigin().x, box.getCurrent().x); 
float top = Math.min(box.getOrigin().y, box.getCurrent().y); 
float bottom = Math.max(box.getOrigin().y, box.getCurrent().y); 


canvas.drawRect(left, top, right, bottom, mBoxPaint); 


} 

以 上 代码 的 第 一 部 分 简单 直接 : 使 用 米 白 背景 paint， 填 充 canvas 以 衬托 矩形 框 

然后 ,针对 矩形 框 数 组 中 的 每 一 个 矩形 框 ， 据 其 两 点 坐标 ,确定 算 形 框 上 下 左右 的 位 置 。 绘 

制 时 ， 左 端 和 顶端 的 值 作为 最 小 值 ， 右 端 和 底 端的 值 作为 最 大 值 。 
完成 位 置 坐标 值 计 算 后 ， 调 用 Canvas .drawRect (.,.) 方 法 ， 在 屏幕 上 绘制 红色 和 矩形 框 。 
运行 DragAndDraw 应 用 ， 尝 试 绘制 一 些 红色 和 矩形 框 ， 如 图 31-5 所 示 。 


WA 7:00 
DragAndDraw 
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图 31-5 程序 员 式 的 情绪 表达 





好 了 ,一 个 捕捉 其 触摸 事 件 并 执行 绘制 的 视图 创建 完成 了 。 
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31.5 “挑战 练习 : 设备 旋转 问题 
设备 旋转 后 ， 已 绘制 的 矩形 框 会 消失 。 要 解决 这 个 问题 ， 可 使 用 以 下 View 方 法 : 


protected Parcelable onSaveInstance9tate() 
protected void onRestoreInstanceState(Parcelable state) 


以 上 方法 的 工作 方式 不 同 于 Activity 和 Fragment 的 onSaveInstanceState(Bundle) 方 
法 。 首 先 ，View 视 图 有 ID 时 ， 才 可 以 调用 它们 。 其 次 ， 相 较 于 BundtLe 参 数 ， 这 些 方法 返回 并 处 
理 的 是 实现 ParceLabtLe 接 口 的 对 象 。 推 荐 使 用 BundtLe , 这 样 就 不 用 自己 实现 ParceLabtLe 接 口 了 。 
(ParcetLabte 接 口 的 实现 很 复杂 ， 如 有 可 能 ， 应 尽量 避免 。) 

最 后 ， 还 需要 保存 BoxDrawingView 的 View 父 视图 的 状态 。 在 Bundle 中 保存 super. 
onSaveInstanceState() 方 法 结果 ， 然 后 调用 super.onRestoreInstanceState(Parcelable) 方 法 
把 结果 发 送 给 超 类 。 
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请 实现 以 两 根 手 指 旋转 矩形 框 。 这 个 练习 有 点 难 ， 想 完成 它 , 需 在 MotionEvent 实 现代 码 中 
处 理 多 个 触 控 点 (pointer )。 当 然 ， 还 要 旋转 canvas。 

要 处 理 多 点 触摸 ， 先 清楚 以 下 概念 。 
口 pointer index: 获知 当前 一 组 触 控 点 中 ， 动 作 事 件 对 应 的 触 控 点 。 
口 pointer ID: 给 予 手势 中 特定 手指 一 个 唯一 的 ID。 
pointer index 可 能 会 变 ， 但 pointer ID 绝对 不 会 变 。 
请 查阅 开发 者 文档 ， 学 习 以 下 MotionEvent 方 法 的 使 用 : 


public final int getActionMasked() 

public final int getActionIndex() 

public final int getPointerId(int pointerIndex) 
public final float getX(int pointerIndex) 
public final float getY(int pointerIndex) 


男 外 ， 还 需 查 查 ACTION_POINTER_UP 和 ACTION_POINTER_DOWN 和 常量 的 用 法 。 
























































属性 动画 














写 出 没有 崩 浊 性 错误 的 代码 ,就 能 做 出 个 勉强 能 用 的 应 用 。 再 多 花 点 心思 , 或 许 就 能 做 出 用 
户 想 用 、 爱 用 的 应 用 。 这 还 不 够 ， 应 用 最 好 能 模拟 物理 世界 ， 给 用 户 真实 临场 的 感觉 。 

真实 世界 灵动 多 变 。 要 让 用 户 界面 动 起 来 , 你 需要 让 用 户 界面 元 素 从 一 个 位 置 动态 移动 到 另 
一 个 位 置 。 

本 章 , 我们 来 开发 一 个 模拟 落日 景象 的 应 用 。 按 住 屏 幕 ， 太 阳 会 慢 慢 落下 海平 面 ， 天空 的 颜 
色 随 之 不 断 变换 ， 犹 如 真 的 日 落 。 


32.1 建立 场景 


首先 是 创建 动画 场景 。 创 建 一 个 名 为 Sunset 的 新 项 目 ， 确 保 minSdkVersion 设 置 为 API 19， 
并 且 使 用 空 activity 模 板 。 将 主 activity 命 名 为 SunsetActivity 。 然 后 把 之 前 项 目的 
SingleFragmentActivityjava 和 activity_ fragment.xml 文 件 复制 到 当前 项 目 。 

海边 落日 光影 变换 ， 色彩 斑 澜 。 因 此 ， 需 要 准备 一 些 色 彩 资 源 。 在 res/values 目 录 中 新 建 
colors.xml 文 件 。 该 资源 文件 内 容 定 义 如 代码 清单 32-1 所 示 。 


代码 清单 32-1 添加 落日 色彩 (res/values/colors.xml ) 


<resources> 
<color name="colorPrimary">#3F51B5</color> 
<color name="colorPrimaryDark">#303F9F</color> 
<color name="colorAccent">#FF4081</color> 
































<color name="bright_sun">#fcfcb7</color> 

<color name="blue_sky">#1le7ac7</color> 

<color name="sunset_sky">#ec8100</color> 

<color name="night_sky">#05192e</color> 

<color name="sea">#224869</color> 
</resources> 


虽然 矩形 视图 模拟 天 空 和 大 海 的 效果 还 可 以 ,但 没 人 见 过 方 方 长 长 的 太阳 吧 ? 技术 实现 简单 
可 不 是 理由 。 所 以 ,在 res/drawable/ 目 录 ， 新 建 一 个 sun.xml 椭 同形 drawable 资 源 ， 如 代码 清单 32-2 
所 示 。 
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代码 清单 32-2 添加 模拟 太阳 的 XML drawable (res/drawable/sun.xml ) 


<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="oval"> 
<solid android:color="@color/bright _ sun" /> 

</shape> 


在 矩形 视图 上 显示 这 个 椭圆 形 drawable， 就 会 看 到 一 个 圆 。 现 在 ， 用 户 一 定 会 点 头 赞 许 , 仿 
佛 看 到 真正 的 太阳 挂 在 天 空 

接 下 来 ， 使 用 一 个 完整 的 布局 文件 构建 整个 场景 。 该 布局 会 在 稍 后 创建 的 SunsetFragment 
中 使 用 ， 因 此 直接 命名 为 fragment_sunset.xml。 布 局 定义 如 代码 清单 32-3 所 示 。 


代码 清单 32-3 ”创建 落日 场景 布局 (res/layout/fragment sunset.xml ) 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 
<FrameLayout 
android:id="@+id/sky" 
android:layout _ width="match_parent" 
android:layout height="0dp" 
android:layout weight="0.61" 
android:background="@color/blue_sky"> 
<ImageView 
android:id="@+id/sun" 
android:layout width="100dp" 
android:layout height="100dp" 
android:layout_gravity="center" 
android:src="@drawable/sun" /> 
</FrameLayout> 






































<View 
android:layout width="match_parent" 
android:layout_height="0Qdp" 
android:layout _ weight="0.39" 
android:background="@color/sea" /> 
</LinearLayout> 











现在 预览 布局 。 怎 么 样 ， 大 海 再 蓝 ， 天 蓝 日 沙 ， 多 么 动人 的 画面 啊 ! 这 不 禁 让 人 念 起 那 去 往 四 


海滩 或 坐 船 出 海 的 过 往 旅程 。 

布局 搞定 了 ， 下 面 要 编写 代码 让 应 用 跑 起 来 。 创 建 一 个 SunsetFragment 类 ， 并 在 其 中 新 增 
一 个 newInstance() 方 法 ,然后 ， 在 onCreateView(...) 方 法 中 ， 实 例 化 fragment _sunset 布 
局 并 返回 结果 视图 ， 如 代码 清单 32-4 所 示 


代码 清单 32-4 ”创建 SunsetFragment 类 ( SunsetFragment.java ) 


public class SunsetFragment extends Fragment { 





























public static SunsetFragment newInstance() { 
return new SunsetFragment(); 


} 





GOverride 
public View onCreateView(LayoutInfLater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.fragment sunset, container, false); 


return view; 


} 


为 显示 SunsetFragment, 让 SunsetActivity 类 继承 SingleFragmentActivity 类 , 如 代码 
清单 32-5 所 示 。 


代码 清单 32-5 ”创建 SunsetFragment 类 ( SunsetActivity.java ) 
public class SunsetActivity extends SingleFragmentActivity { 
@Override 


protected Fragment createFragment() { 
return SunsetFragment.newInstance(); 


运行 Sunset 应 用 。 一 切 正 常 的 话 ， 可 看 到 如 图 32-1 所 示 的 画面 。 


Sunset 





图 32-1 落日 徐徐 
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32.2 简单 属性 动画 


创建 完 落 日 场景 ， 现 在 要 实现 太阳 徐徐 落下 海平 面 的 动画 效果 。 
首先 ,你 需要 在 fragment 中 获取 一 些 必要 的 信息 。 在 onCreateView(...) 方 法 中 ,获取 要 控 
制 的 视图 并 存 入 相应 变量 中 备用 ， 如 代码 清单 32-6 所 示 。 


代码 清单 32-6 ”获取 视图 引用 ( SunsetFragment.java ) 


public class SunsetFragment extends Fragment { 








private View mSceneView; 
private View mSunView; 
private View mSkyView; 


public static SunsetFragment newInstance() { 
return new SunsetFragment(); 


} 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.fragment sunset, container, false); 


mSceneView = view; 
mSunView = view.findViewById(R.id.sun); 
mSkyView = view.findViewById(R.id.sky); 


return view; 


} 

做 完了 准备 工作 , 接 下 来 就 是 编码 实现 了 。 从 技术 上 讲 ， 所谓 太阳 落下 海平 面 ， 实际 就 是 平 
地 移动 nSunView 视 图 ,直到 它 的 顶部 刚好 与 海平 面 的 顶部 边缘 重合 ,这 可 以 通过 改变 mSunView 
图 顶部 的 坐标 位 置 来 实现 。 

显然 ， 这 需要 知道 动画 的 开始 和 结束 点 。 这 个 任务 就 交 给 startAnimation() 方 法 处 理 
代码 清单 32-7 所 示 。 


代码 清单 32-7 获取 视图 的 顶部 坐标 位 置 ( SunsetFragment.java ) 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 





























0 工 
» 

汪 
一 








} 


private void startAnimation() { 
float sunYStart = mSunView.getTop(); 
float sunYEnd = mSkyView.getHeight(); 
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和 View 视 图 类 的 getBottom()、getRight() 和 getLeft() 方 法 一 样 ，getTop() 方 法 可 以 返 
回 自己 的 local layoutrect。 视 图 的 local1layoutrect 是 其 相对 父 视图 的 位 置 和 其 尺寸 大 小 的 描述 。 视 











图 一 旦 实例 化 , 这 些 值 都 是 相对 固定 的 。 虽然 可 以 修改 这 些 值 ， 从 而 改变 视图 的 位 置 , 但 不 推荐 











这 么 做 。 要 知道 ， 每 次 布局 切换 时 ， 这 些 值 都 会 被 重 置 ， 所 以 才 会 有 相对 固定 一 说 。 





























无 论 怎样 ， 动 画 的 开始 点 都 是 msunView 视 图 的 顶部 位 置 。 结 束 点 是 其 父 视图 mSkyView 的 底 
部 位 置 。 移 动 距离 是 调用 getHeight () 方 法 返回 的 mSkyView 高 度 。 除 了 getHeight () 方 法 ， 调 





用 getBottom() 和 getTop () 方 法 并 取 差 值 也 能 获得 相同 结果 。 





知道 了 动画 的 开始 和 结束 点 ,创建 一 个 0bjectAnimator 对 象 执行 动画 ,如 代码 清单 32-8 所 示 。 


代码 清单 32-8 创建 模拟 太阳 的 animator 对 象 (SunsetFragment,java ) 


private void startAnimation() { 
float sunYStart = mSunView.getTop(); 
float SunYEnd = mSkyView.getHeight(); 


ObjectAnimator heightAnimator = 0bjectAnimator 
.ofFloat (mSunView, "y", sunYStart, sunYEnd) 
.SetDuration(3200); 


heightAnimator.start(); 
} 








在 onCreateView() 方 法 中 ， 为 msceneView 视 图 设置 监听 器 。 只 要 用 户 点 击 它 ， 就 调用 











startAnimation() 方 法 执行 动画 ， 如 代码 清单 32-9 所 示 。 


代码 清单 32-9 ”响应 触 摸 ， 执 行动 画 ( SunsetFragment.java ) 


public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = infLater,infLate(R.Layout.fragment sunset, container, false); 


mSceneView = view; 
mSunView = view.findViewById(R.id.sun); 
mSkyView = view.findViewById(R.id.sky); 


mSceneView.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
startAnimation(); 
} 
}); 


return view; 


} 
运行 Sunset 应 用 。 点 击 应 用 界面 任意 处 ， 欣 赏 一 段 美丽 的 落日 动画 ， 如 图 32-2 所 示 。 
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最 后 ， 


动画 效果 ， 


Sunset 





图 32-2 落日 


来 看 看 这 段 动画 的 实现 原理 : 0bjectAnimator 是 个 属性 动画 制作 对 象 。 要 获得 某 种 
传统 方式 是 设法 在 屏幕 上 移动 视图 ,而 属性 动画 制作 对 象 却 男 辟 蹊 径 : 以 一 组 不 同 的 

















参数 值 反 复 调用 属性 设置 方法 。 
调用 以 下 方法 可 以 创建 0ObjectAnimator 对 象 : 


ObjectAnimator.ofFloat(mSunView, "y", 0, 1) 


上 例 中 , 新 建 0ObjectAnimator 一 旦 启动 , 就 会 以 从 0 开始 递增 的 参数 值 反 复 调用 mSunView. 
setY(float) 方 法 : 

mSunView. setY(0); 

mSunView. setY(0.02); 


mSunView.setY(0.04); 
mSunView.setY(0.06); 


mSunView.setY(0.08); 


直到 调用 mSunView. setY(1) 为 止 。 这 个 0~1 区 间 参 数值 的 确定 过 程 又 称 为 interpolation。 可 3 


以 想象 到 ， 




















在 这 个 interpolation 过 程 中 ， 即 便 很 短暂 ,确定 相 邻 参数 值 也 是 要 耗费 时 间 的 ; 由 于 人 


眼 的 视觉 暂 留 现象 ， 动 画 效 果 就 形成 了 。 
32.2.1 视图 属性 转换 


想 让 视图 动 起 来 的 话 ， 仪 仅 靠 属性 动画 制作 对 象 是 不 切实 际 的 ， 尽 管 它 确实 很 用。 因此 ， 
有 了 属性 转换 ( transformation properties ) 这 个 合作 伙伴 。 
前 面 说 过 ， 视 图 都 有 local layout rect ( 视图 实例 化 时 被 赋予 的 位 置 及 大 小 尺寸 参数 值 )。 知 道 


了 视图 属 怕 

















FE 值 (local layout rect )， 就 可 以 改变 这 些 属性 值 ， 从 而 实现 四 处 移动 视图 。 这 种 做 法 就 
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叫 作 属性 转换 。 例 如 ， 利 用 rotation、pivotX 和 pivotY 这 三 个 参数 可 以 旋转 视图 ( 见 图 32-3 ); 
利用 scaleX 和 scaleY 可 以 缩放 视图 ( 见 图 32-4 ); 而 利用 transLationX 和 transLationY 可 以 四 
处 移动 视图 ( 见 图 32-5 )。 


pivot XX& 
pivot Y 





图 32-3 ”视图 旋转 





scaleY 





图 32-4 ”视图 缩放 








translation X & 
translation Y 





图 32-5 ”视图 移动 
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视图 的 所 有 这 些 属 ee 例如 ， 调 用 getTranstLationX() 方 法 就 
能 得 到 transtLationX 值 ， 调 用 setTransLationX(ftLoat) 方 法 就 能 设置 transLationX 值 。 
那么 y 属 ee 实际 上 ，x 和 y 属 性 是 以 布局 坐标 为 参考 值 设立 的 一 种 便利 开发 的 
属性 值 。 例 如 ， 简 单 写 几 行 代 码 ， 就 可 以 把 视图 置 于 某 个 X 和 Y 坐 标 确定 的 位 置 。 分 析 其 背后 原 
理 可 知 ， 这 就 是 通过 修改 transtLationX 和 transtationY 属 性 值 来 实现 的 。 所 以 ， 调 用 
mSunView. setY(50) 方 法 就 等 同 于 : 


mSunView.setTranslationY(50 - mSunView.getTop()) 






























































32.2.2 ”使 用 不 同 的 interpolator 


目前 ，Sunset 应 用 的 动画 效果 还 不 够 完美 。 假 设 太阳 一 开始 静止 于 天 空 ， 在 进入 落下 的 动画 
时 , 应 该 有 个 加 速 过 程 。 这 也 好 办 , 使 用 TimeInterpolator 就 可 以 了 。3 这 个 TimeInte rpolator 
的 作用 就 是 : 改变 4 点 到 8B 点 的 动画 效果 。 

在 startAnimation() 方 法 中 ,添加 代码 清单 32-10 所 示 代 码 ， 使 用 一 个 AccelerateInterpo- 
Lator 对 象 实现 太阳 加 速 落下 的 特效 。 


代码 清单 32-10 ”添加 加 速 特效 ( SunsetFragment.java ) 


private void startAnimation() { 
float sunYStart = mSunView.getTop(); 
float sunYEnd = mSkyView.getHeight(); 






































ObjectAnimator heightAnimator = 0bjectAnimator 
.ofFloat(mSunView, "y", sunYStart, sunYEnd) 
.SetDuration(3000); 

heightAnimator.setInterpoLator(new AccelerateInterpolator()); 


heightAnimator. start(); 
} 
重新 运行 Sunset 应 用 。 点 击 屏幕 观察 动画 效果 。 这 次 ， 太 阳 先 是 慢 慢 落 下 ， 然 后 朝 着 海平 面 
方向 加 速 坠落 。 
使 用 不 同 的 TimeInterpolator 对 象 可 实现 不 同 的 动画 特效 。 想 要 了 人 解 Android 自 带 的 
TimeInterpolator 还 有 哪些 ， 请 参阅 TimeInterpolator 参 考 文档 的 Known Indirect Subclasses 2 
部 分 。 


32.2.3 色彩 渐变 


优化 完 落 日 的 动画 效果 ,接着 处 理 天 空 随 日 落 所 呈现 的 色彩 变换 效果 ,在 onCreateView(...) 
方法 中 ， 获 取 colors.xml 文 件 定义 的 色彩 资源 并 存 人 相应 的 实例 变量 ， 如 代码 清单 32-11 所 示 。 
























































代码 清单 32-11 取出 日 落 色彩 资源 ( SunsetFragment.java ) 


public class SunsetFragment extends Fragment { 
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private View mSkyView; 


private int mBlueSkyColor; 
private int mSunsetSkyColor; 
private int mNightSkyColor; 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 


Bundle savedInstanceState) { 
mSkyView = view.findViewById(R.id.sky); 


Resources resources = getResources(); 

mBLueSkyCoLor = resources.getColor(R.color.blue sky); 
mSunsetSkyColor = resources.getColor(R.color.sunset sky); 
mNightSkyColor = resources.getColor(R.color.night sky); 


mSceneView.setOnClickListener(new View.OnClickListener() { 


}); 


return view; 


} 


在 startAnimation() 方 法 中 ,参照 代码 清单 32-12 再 添加 一 个 0bjectAnimator， 实 现 天 空 





色彩 从 mBlueSkyColor 到 mSunsetSkyColor 变 换 的 动画 效果 。 


代码 清单 32-12 ”实现 天 空 的 色彩 变换 ( SunsetFragment.java ) 


private void startAnimation() { 
float sunYStart = mSunView.getTop(); 
float sunYEnd = mSkyView.getHeight(); 


ObjectAnimator heightAnimator = ObjectAnimator 
.OfFloat(mSunView, "y", sunYStart, sunYEnd) 
.SetDuration(3000); 

heightAnimator.setInterpolator(new AccelerateInterpolator()); 


ObjectAnimator sunsetSkyAnimator = ObjectAnimator 


.OfInt(mSkyView, "backgroundColor", mBlueSkyColor, mSunsetSkyColor) 


.SetDuration(3000); 


heightAnimator. start(); 
sunsetSkyAnimator. start(); 


} 














天 空 的 动画 效果 似乎 就 这 么 完成 了 。 运 行 SunSet 应 用 看 看 吧 。 怎 么 ,似乎 不 大 对 劲 啊 ! 从 蓝 








色 到 桶 黄色， 天 空 的 色彩 变化 太 人 夸张 了 ， 一 点 都 不 自然 。 








仔细 分 析 就 知道 ， 颜 色 int 数 值 并 不 是 个 简单 的 数字 。 它 实际 是 由 四 个 较 小 数字 转换 而 来 。 


因此 ， 只 有 知道 颜色 的 组 成 奥秘 ，0bjectAnimator 对 象 才能 合理 地 确定 蓝 色 和 桶 黄色 之 间 的 中 





间 值 Lo 








不 过 ， 知 道 如 何 确定 颜色 中 间 值 还 不 够 ，0bjectAnimator 还 需要 一 个 TypeEvaLuator 子 类 
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的 协助 。TypeEvaLuator 能 帮助 0bjectAnimator 对 象 精确 地 计算 开始 到 结束 间 的 递增 值 。 
Android 提 供 的 这 个 TypeEvaLuator 子 类 叫 作 ArgbEvaLuator， 如 代码 清单 32-13 所 示 。 


代码 清单 32-13 ”使 用 ArgbEvaluator ( SunsetFragment.java ) 


private void startAnimation() { 
float sunYStart = mSunView.getTop(); 
float sunYEnd = mSkyView.getHeight(); 


ObjectAnimator heightAnimator = 0bjectAnimator 
.ofFloat(mSunView, "y", sunYStart, sunYEnd) 
.SetDuration(3000); 

heightAnimator.setInterpolator(new AccelerateInterpolator()); 


ObjectAnimator sunsetSkyAnimator = 0bjectAnimator 
.OfInNnt(mSkyView, "backgroundColor", mBlueSkyColor, mSunsetSkyColor) 
.SetDuration(3000); 

sunsetSkyAnimator.setEvaluator (new ArgbEvaluator()); 


heightAnimator. start(); 
sunsetSkyAnimator. start(); 
} 


再 次 运行 Sunset 应 用 。 夕 阳 西 下 ， 从 蓝 色 到 桶 黄色， 色彩 的 过 渡 终 于 自然 了 。 


Sunset 





图 32-6 天空 的 色彩 随 日 落 变 换 


32.3 播放 多 个 动画 
有 时 ， 你 需要 同时 执行 一 些 动 画 。 这 很 简单 ， 同 时 调用 start ( ) 方 法 就 行 了 。 
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但 是 , 假如 要 像 编排 舞步 那样 编排 多 个 动画 的 执行 , 事情 就 没 那 么 简单 了 。 例如 ， 为 实现 完 
整 的 日 落 景象 ， 太 阳 落 下 去 之 后 ， 天 空 应 该 从 橘 黄色 再 转 为 午夜 蓝 。 

办 法 总 是 有 的 ， 你 可 以 使 用 AnimatorListener。AnimatorListener 会 让 你 知道 动画 什么 
时 候 结 束 。 这 样 ， 执 行 完 第 一 个 动画 ， 就 可 以 接力 执行 第 二 个 夜空 变化 的 动画 。 然 而 ， 理 论 分 析 
很 简单 ， 实 际 去 做 的 话 ， 少 不 了 要 准备 多 个 监听 器 ， 这 也 很 麻烦 。 好 在 Android 还 设计 了 方便 又 


简单 的 AnimatorSet。 下 面 就 来 学 习 使 用 它 。 
首先 ， 删 除 掉 原来 的 动画 启动 代码 ， 并 添加 夜空 变化 的 动画 代码 ， 如 代码 清单 32-14 所 示 


代码 清单 32-14 ”创建 夜空 动画 ( SunsetFragment.java ) 


private void startAnimation() { 






















































































sunsetSkyAnimator.setEvaluator(new ArgbEvaluator()); 


ObjectAnimator nightSkyAnimator = 0bjectAnimator 
.OfInt(mSkyView, "backgroundColor", mSunsetSkyColor, mNightSkyColor) 


.SetDuration(1500); 
nightSkyAnimator.setEvaluator (new ArgbEvaluator()); 


heiohtAni DO 
SthSetSkyAninmater-s 卡 aF 二 (二 


} 
然后 ， 创 建 并 执行 一 个 动画 集 ， 如 代码 清单 32-15 所 示 。 





代码 清单 32-15 ”创建 动画 集 ( SunsetFragment.java ) 


private void startAnimation() { 


ObjectAnimator nightSkyAnimator = 0bjectAnimator 
.OfInt(mSkyView, "backgroundColor", mSunsetSkyColor, mNightSkyColor) 


.SetDuration(1500); 
nightSkyAnimator.setEvaluator(new ArgbEvaluator()); 


AnimatorSet animatorSet = new AnimatorSet(); 


animatorSet 
.play (heightAnimator) 


.with(sunsetSkyAnimator) 
.before(nightSkyAnimator); 
animatorSet .start(); 


} 
说 白 了 ,AnimatorSet 就 是 可 以 放 在 一 起 执行 的 动画 集 。 可 以 用 好 儿 种 方式 创建 动画 


使 用 上 述 代码 中 的 play (Animator) 方 法 最 容易 。 
调用 play (Animator) 方 法 之 前 , 要 先 创 建 一 个 AnimatorSet.Builder 对 象 ,然后 利用 它 创 
建 链 式 方法 调用 。 传人 play (Animator) 方 法 的 Animator 是 链 首 。 所 以 ,以 上 代码 中 的 链 式 调用 


解读 : 协同 执行 heightAnimator 和 sunsetSkyAnimator 动 画 , 在 nightSkyAnimator 
到 更 复杂 的 动画 集 。 这 也 没 问题 ， 需 





E， 但 




















就 可 以 这 检 
之 前 执行 heightAnimator 动 画 。 在 实际 开发 中 ， 可 能 会 月 





32.5 ”挑战 练习 527 





要 的 话 ， 可 以 多 次 调用 play (Animator) 方 法 。 
次 运行 Sunset 应 用 。 用 心 感受 下 这 幅 动 人 祥和 的 画面 ， 真是 太 棒 了 1! 


























32.4 深入 学 习 : 其 他 动画 API 


除了 广 受 欢迎 的 属性 动画 ，Android 动 画工 具 箱 里 还 有 一 些 其 他 动画 工具 。 不 管用 不 用 ,， 花 
点 时 间 了 解 一 下 总 没 错 。 























32.4.1 传统 动画 工具 


Android 有 个 叫 作 android.view.animation 的 动画 工具 类 包 。Honeycomb 发 布 时 , 又 引入 了 
一 个 更 新 的 android.animation 包 。 这 是 两 个 不 同 的 包 ， 请 注意 区 分 。 

它们 都 是 传统 的 动画 工具 包 ， 简 单 了 解 就 可 以 了 。 注 意 到 了 吗 ? 本 章 使 用 的 动画 工具 类 的 
类 名 都 为 animaTOR。 如 果 遇 到 animaTION 这 样 的 类 名 ， 就 能 断定 它 来 自传 统 动画 工具 包 ， 直 接 
忽略 好 了 ! 


32.4.2 ” 转 场 


Android 4.4 引 入 了 新 的 视图 转 场 框 架 。 从 一 个 activity 小 视图 动态 弹出 男 一 个 放大 版 activity 视 
图 就 可 以 使 用 转 场 框架 实现 。 

实际 上 ， 转 场 框架 的 工作 原理 很 简单 : 定义 一 些 场景 ,它们 代表 各 个 时 点 的 视图 状态 ,然后 
按照 一 定 的 逻辑 切换 场景 。 场 景 在 XML 布局 文件 中 定义 ， 转 场 在 XML 动画 文件 中 定义 。 

在 本 章 日 落 例子 中 ，activity 已 经 运行 了 ,这 种 情况 就 不 太 适 合 使 用 转 场 框架 ， 所 以 我 们 用 了 
强大 的 属性 动画 框架 。 

再 以 CriminalIntent 应 用 中 人 处理 crime 图 片 为 例 ,如 果 想 实现 以 弹 窗 展示 放大 版 图 片 这 样 的 动画 
效果 ,首先 要 知道 照片 放 在 哪里 ， 其 次 是 如 何在 对 话 框 里 布置 新 图 片 。 显 然 , 对 于 这 类 布局 动态 
转 场 任务 ， 转 场 框 架 比 0bjectAnimator 更 能 胜任 。 


32.5 ”挑战 练习 


首先 ， 让 日 落 可 逆 。 也 就 是 说 ， 点 击 屏 幕 ， 等 太阳 落下 后 ， 再 次 点 击 屏 幕 ， 让 太阳 升 起 来 。 
动画 集 不 能 逆向 执行 ， 因 此 ， 你 需要 新 建 一 个 AnimatorSet。 
第 二 个 挑战 是 添加 太阳 动画 特效 ， 让 它 有 规律 地 放大 、 缩 小 或 是 加 一 圈 旋 转 的 光线 。( 这 实 
际 是 反复 执行 一 段 动画 特效 ， 可 考虑 使 用 0bjectAnimator 的 setRepeatCount(int) 方 法 。) 

另外 , 海面 上 要 是 有 太阳 的 倒影 就 更 真实 了 。 

最 后 , 再 来 看 个 颇具 挑战 的 练习 。 在 日 落 过 程 中 实现 动画 反 转 。 在 太阳 慢 慢 下 落 时 点 击 屏幕 ， 
让 太阳 无 颖 回升 至 原来 所 在 的 位 置 。 或 者 , 在 太阳 落下 进入 夜晚 时 点 击 屏 幕 ， 让 太阳 重新 升 回 天 
空 ， 就 像 日 出 。 


























































































































地 理 位 置 和 Play 服务 








本 章 ， 我 们 来 编写 一 个 叫 作 Locatr 的 应 用 。Locatr 支 持 基 于 地 理 位 置 的 Flickr 





图 片 搜 索 。 它 首 


先 会 定位 用 户 的 当前 位 置 ， 然 后 搜索 附近 的 图 片 ( 如 图 33-1 所 示 ) 下 一 章 ， 应 用 升级 后 ， 图 片 








还 会 显示 在 地 图 上 。 





Locatr 








图 33-1 ”Locatr 应 用 效果 图 














用 户 当 前 位 置 定 位 简单 又 有 趣 。 但 需要 把 一 个 叫 作 Google Play Service 的 非 标 准 库 整 合 进 应 








用 。 


33.1 地 理 位 置 和 定位 类 库 





为 啥 要 整合 其 他 库 呢 ? 稍 后 会 解答 。 现 在 我 们 先 看 看 原生 Android 设 备 能 提供 啥 定位 数据 。 





再 看 看 Android 又 提供 了 哪些 工具 ， 使 用 它们 又 能 得 到 什么 样 的 定位 数据 。 
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Android 原 生 系 统 提 供 了 一 些 基 本 地 理 位 置 API。 使 用 这 些 API， 应 用 可 以 从 各 种 信息 源 接收 
地 理 位 置 数据 。 对 大 多 数 手机 来 说 ， 这 些 信息 源 是 指 来 自 GPS 定 位 仪 (数据 较 精 准 ) 以 及 来 自 手 
机 基站 或 Wi-Fi 连 接 的 地 理 位 置 数 据 。 这 些 API 在 刚 有 Android 的 时 候 就 有 了 ， 可 以 在 
android.Location 库 包 中 找到 。 

虽然 它们 早已 存在 ， 但 无 法 满足 所 有 需求 场景 。 真 实 世 界 里 的 应 用 往往 有 这 样 的 需求 ,“ 请 
尽 可 能 给 我 最 精确 的 定位 数据 , 费 不 费 电 没 关系 ”, 或 者 “我 需要 定位 数据 , 最 好 是 不 要 太 费 电 ”。 
而 像 “请 启动 GPS 定位 仪 ， 给 个 定位 数据 就 行 了 ”这 样 没 啥 要 求 的 却 不 多 见 。 

一 旦 你 带 着 手机 到 处 跑 ， 问 题 更 加 凸显 。 如 果 在 户外 ，GPS 最 合适 。 如 果 GPS 没 信号 ， 手 机 
基站 定位 也 不 错 。 如 果 两 者 都 不 行 ， 凑 合 使 用 加 速 感应 器 和 陀螺 仪 也 总 比 完全 没 方向 要 强 。 

过 去 ， 为 获得 定位 数据 , 严肃 应 用 必须 手动 调用 上 述 各 种 数据 源 ， 并且 要 根据 不 同 场景 适时 
切换 。 这 实施 起 来 比较 复杂 ， 难 以 把 握 。 












































Google Play Service 


考虑 到 上 述 情况 ， 就 迫切 需要 更 好 的 定位 API。 然 而 ， 如 果 要 把 这 样 的 API 加 入 标准 库 ， 开 
发 人 员 不 知道 猴 年 马 月 才能 用 得 到 。 这 就 比较 尴 软 了 ,操作 系统 可 是 拥有 定位 所 需 的 一 切 人 硬件 的 : 
GPS、 手 机 基站 定位 等 。 

还 好 ， 标 准 库 并 不 是 Google 发 布 API 的 唯一 途径 。 除 了 标准 库 ， 它 还 提供 了 Google Play 
Service。 这 是 一 套 随 Google Play 商店 应 用 安装 的 常用 服务 。 为 解决 定位 疑难 问题 ，Google 在 Play 
服务 中 提供 了 叫 作 Fused Location Provider 的 全 新 定位 服务 。 

既然 这 些 库 包 含 在 其 他 应 用 里 ,那么 首先 要 安装 这 些 应 用 。 同 时 ， 这 也 意味 着 要 安装 Play 商 
店 应 用 并 且 随 时 保持 更 新 。 而 且 ， 你 的 应 用 也 要 通过 Play 商店 发 布 。 如 果 做 不 到 ,不 好 意思 ， 请 
使 用 其 他 定位 API 吧 。 

对 于 Locatr 应 用 ， 如 果 使 用 物理 设备 ， 请 确保 Play 商 店 应 用 已 更 新 到 最 新 。 要 是 使 用 模拟 器 
呢 ?” 别 担心 ， 稍 后 就 会 提供 解决 办 法 。 






























































33.2 创建 Locatr 项 目 


理论 知识 已 足够 ， 可 以 创建 应 用 了 。 在 Android Studio 中 ,创建 一 个 叫 作 Locatr 的 新 项 目 。 创 
建 一 个 空 activity 并 将 其 命名 为 LocatrActivity, 最 低 SDK 版 本 为 API 19。 然后 将 SingleFragment- 
Activity.java 和 activity_fragment.xml 文 件 分别 复 制 到 Locatr 项 目的 对 应 目录 。 

Locatr 应 用 也 需要 搜索 Flickr， 所 以 为 了 方便 ， 它 需要 PhotoGallery 应 用 中 的 一 些 查询 代码 。 
从 PhotoGallery 的 随 书 项 目 文件 中 找到 FlickrFetchr.java 和 GalleryItem.java( 建议 使 用 第 27 章 的 文 
件 )， 将 它们 复制 到 Locatr 项 目的 对 应 目录 。 

Locatr 应 用 的 用 户 界面 稍 后 创建 。 如 果 使 用 模拟 器 ,请 继续 阅读 下 一 节 配 置 测试 环境 。 否 则 ， 
请 直接 跳 到 33.4 节 。 


























530 第 33 章 地 理 位 置 和 Play 服务 





33.3 ”Play 服务 定位 和 模拟 器 


如 果 使 用 AVD 模 拟 器 ， 请 确保 模拟 器 镜像 已 更 新 到 最 新 版 本 。 

为 更 新 镜像 文件 ， 打 开 SDK 管 理 器 ( Tools 一 Android 一 SDK Manager )。 找 到 你 要 使 用 的 
Androd 版 本 ， 并 确认 Google APIs System Images 已 安装 并 更 新 至 最 新 。 如 提示 有 更 新 ， 请 按照 提 
示 完 成 更 新 ( 如 图 33-2 所 示 )。 

















SDK Path: 
Packages 
嘲 ' Name API Rev. Status 
了 Anarola SUK BuNg-rools 19.1 LNorinstanea 
YE3 Android 7.0 (API 24) 
Documentation for Android SDK 24 1 Not installed 
响 ' SDK Platform 24 3 了 戈 Installed 
嘲 Android TV Intel x86 Atom Svstem Imaae 24 关 Not installed 
国 Android Wear ARM EABI v7a Svstem Imaae 24 y Not installed 
园 Android Wear Intelx86 Atom Svstem maae 24 1 Not installed 
ARM 64 v8a Svstem Imaae 24 Not installed 
嘿 ARM EABI v7a Svstem Imaae 24 7 Not installed 
国 /ntel x86 Atom 64 Svstem Imaae 24 7 [DNotinstalled 
v 国 Intel x86 Atom System Image 24 ”6 局 Updateavailable: rev 7 
国 Gooole APls ARM 64 v8a Svstem Imaae 24 8 Not installed 
国 Gooole APls ARM EABI v7a Svstem Imaae 24 8 Not installed 
国 Gooole APls /ntelx86 Atom 64 Svstem Image 24 8 Not installed 
U 国 Gooole APls Intel x86 Atom Svstem Imaae 24 8 Not installed 
时 Gooole APls 24 Not installed 
人 Sources for Android SDK 24 1 成 Installed 
v C3 Android 6.0 (API 23) 
嘱 ' SDK Platform 23 3 世 Installed 
DB Anmrnin TW Ap EAR1 1 72 Gurtam imanm 22 2 Nat inetalian, 
Show: v Updates/New v Installed SelectNew orUpdates Install 8 packages... 
Obsolete Deselect All Delete 7 packages... 


Om 


Done loading packages. 


图 33-2 ”确保 模拟 器 已 更 新 


AVD 模 拟 器 也 应 有 个 支持 指定 版 本 Google API 的 目标 操作 系统 。 创 建 模拟 器 时 ， 选 择 目 标 操 
作 系 统 版 本 (with Google APIs ) 时 会 看 到 API 级 别 。 对 于 Locatr 项 目 ， 选 择 API 21 级 或 更 高 即 可 
(如 图 33-3 所 示 )。 





ee Virtual Device Configuration 


System Image 
Android Studio 


Select a system image 


x6 imaoes Other Ima0es 








Nougat 
Release Name APLLevel ~ ABl Target 
Nougat 24 X86 Android 7.0 (with Google AP 
Apl level 
Marshmallow Download 23 x86 Android 6.0 (with Google AF 
Marshmallow Download 。 23 x86_64 Android 6.0 (with Coogle AF 
Lollipop Download 22 x86.64 Android 5.1 (with Coogle AF Re 
RR 攻 
Lollipop Download 22 x86 Android 5.1 (with Google AF| WS Google Inc. 
System maoe 
x86_64 
These images are recommended because they run 
the fastest and include support for Google APIs 
Questions on APl level? 
See the APl level distribution chart 
马 
3 oneal 而 Provow Finish 


图 33-3 ”选择 API 级 别 
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如 果 先 前 已 搭建 了 合适 的 模拟 器 ,同样 需要 更 新 至 最 新 版 本 。 完 成 更 新 后 ， 记 得 重启 模拟 器 
让 其 生效 。 
模拟 定位 数据 

在 模拟 器 上 ， 你 也 需要 不 断 更 新 的 地 理 位 置信 息 用 于 测试 。Android Studio 提 供 模 拟 器 控制 
面板 , 可 以 发 送 地 理 位 置 坐 标 给 模拟 絮 ; 但 它 只 适用 于 以 前 的 定位 服务 , 不 能 用 于 Fused Location 
Provider。 看 来 ， 只 能 以 代码 的 方式 发 送 地 理 位 置信 息 了 。 

在 Big Nerd Ranch 培 训 基地 ， 只 要 你 感 兴趣 ， 任 何 主题 我 们 都 愿意 细 细 讲 给 你 听 。 不 过 , 在 
遭遇 了 狩猎 教学 大 失败 之 后 , 我们 终于 明白 不 能 这 样 教 了 。 现在, 我们 更 实际 , 更 乐意 传授 一 些 
学 生 最 急需 、 更 有 用 的 知识 。 所 以 ,我 们 放弃 了 教授 如 何 编写 模拟 数据 发 送 代 码 ， 而 是 为 你 写 了 
一 个 叫 作 MockWalker 的 独立 应 用 。 要 使 用 它 , 请 从 以 下 地 址 下 载 并 安装 其 APK: https://www.bign 
erdranch.com/solutions/Mock Walker.apk。 

最 容易 安装 的 方式 是 打开 模拟 器 上 的 浏览 需 应 用 ， 输 入 地 址 ， 如 图 33-4 所 示 。 

下 载 完 成 后 ， 点 击 工具 栏 的 下 载 通知 项 打开 这 个 APK 完 成 安装 ， 如 网 33-5 所 示 。 
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rdranch.com/solutions/MockWalker.apk @ 


bignerdranch.com/solutions/MockWalker.apk @ MockWalker-debug.apk 1:31PM 


bignerdranch.com/solutions/MockWalker.apk Download complete 


https://www.bignerdranch.com/solutions/Mod| 三 
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图 33-4 ”输入 下 载 地 址 图 33-5 打开 下 载 文件 


MockWalker 会 触发 一 个 模拟 步行 行为 ， 通 过 服务 把 模拟 地 理 位 置 数据 发 送 给 Fused Location 
Provider。 应 用 运行 后 ， 它 会 假装 在 亚特兰大 的 柯 克 伍德 附近 转悠 。 

服务 运行 时 , 只 要 Locatr 应 用 向 Fused Location Provider 请 求 定 位 数据 , 它 就 会 收 到 MockWalker 
发 布 的 地 理 位 置 数 据 ( 如 图 33-6 所 示 )。 
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MockWalker 





,二 /二 


图 33-6 ”运行 MockWalker 











运行 MockWalker 应 用 并 点 击 Start 按 钮 。 即 使 退出 应 用 ， 服 务 也 会 一 直 在 后 台 运 行 。( 千 万 不 
要 退出 模拟 器 。) 使 用 完毕 或 不 再 需要 的 话 ， 就 





日 








重新 打开 MockWalker 应 用 ， 点 击 Stop 按 钮 关闭 。 
如 果 想 了 解 MockWalker 应 用 的 工作 原理 ， 可 以 查看 它 的 源码 ( 见 随 书 代码 文件 )。 为 管理 持 
续 的 地 理 位 置 更 新 ， 该 应 用 使 用 了 RxJava 和 sticky 前 台 服务 技术 。 


33.4 创建 Locatr 应 用 























接 下 来 , 为 Locatr 应 用 创建 月 


有 户 界面 。 首先, 为 搜索 按钮 添加 字符 串 资 源 , 如 代码 清单 33-1 所 示 。 
代码 清单 33-1 添加 搜索 按钮 文字 (res/values/strings.xml ) 











<resources> 
<string name="app_ name">Locatr</string> 
<string name="search">Find an image near you</string> 
</resources> 
老 规矩 ， 你 需要 一 个 fragment， 所 以 重 命名 activity_locatr.xml 布 局 文件 为 fragment locatrxml。 
修改 RelativeLayout 控 件 ， 使 用 一 个 ImageView 控 件 显示 搜索 到 的 


图 片 ， 如 图 33-7 所 示 。 
(padding 属 性 值 不 重要 ， 如 果 模 板 自 带 ， 可 直接 删除 。) 
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RelativeLayout 


| 


ImageView 
android: id="@+id/image" 
android: layout_width="150dp" 
android: layout_height="150dp" 


android:background="@android:color/white" 





android: layout_centerInParent="true" 

















图 33-7 ”Locatr 应 用 的 布局 ( res/layout/fragment locatr.xml ) 


Locatr 应 用 还 需要 一 个 按钮 触发 搜索 。 这 里 ， 可 以 利用 工具 栏 来 实现 。 创 建 res/menu/ 
fragment locatrxml 菜 单 文件 。 然 后 添加 菜单 项 以 显示 一 个 搜索 按钮 ， 如 代码 清单 33-2 所 示 。( 没 
错 ， 菜 单 文 件 名 和 res/layout/fragment locatr.xml 一 样 。 这 没 问 题 ， 菜 单 资源 和 布局 资源 的 命名 空 
间 是 不 同 的 。) 


代码 清单 33-2 ”配置 菜单 (res/menu/fragment locatrxml ) 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 
<item android:id="@+id/action locate" 
android:icon="@android:drawable/ic_menuyu_compass" 
android:title="@string/search" 
android:enabled="false" 
app:showAsAction="ifRoom"/> 
</menu> 


按钮 默认 是 禁用 的 。 后 面 ， 连 上 Play 服务 之 后 就 启用 它 。 
现在 ， 创 建 一 个 名 为 LocatrFragment 的 子 类 ， 继 承 Fragment， 并 在 其 中 实例 化 布局 ， 显 示 
ImageView 视 图 ， 如 代码 清单 33-3 所 示 。 


代码 清单 33-3 ”创建 LocatrFragment (LocatrFragment.java ) 


public class LocatrFragment extends Fragment { 
private ImageView mImageView; 



























































public static LocatrFragment newInstance() { 
return new LocatrFragment(); 





} 
@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container， 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.fragment locatr, container, false); 


mImageView = (ImageView) v.findViewById(R.id.image); 


return v; 
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} 
接着 ， 完 成 菜单 项 的 创建 ， 如 代码 清单 33-4 所 示 。 
代码 清单 33-4 ”添加 菜单 〈LocatrFragment.java ) 


public class LocatrFragment extends Fragment { 
private ImageView mImageView; 





public static LocatrFragment newInstance() { 
return new LocatrFragment(); 


} 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setHasOptionsMenu (true); 


} 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 


} 


@Override 

public void onCreate0ptionsMenu(Menu menu, MenuInflater inflater) { 
super.onCreateOptionsMenu(menu, inflater); 
inflater.inflate(R.menu.fragment locatr, menu); 


} 
最 后 ， 把 LocatrFragment 交 给 LocatrActivity 托 管 ， 如 代码 清单 33-5 所 示 。 























代码 清单 33-5 ”托管 Locatr fragment ( LocatrActivity.java ) 


public class LocatrActivity extends SingleFragmentActivity { 
@Override 
protected Fragment createFragment() { 
return LocatrFragment .newInstance() ; 
} 
} 


至 此 ，Locatr 应 用 的 用 户 界面 搞定 了 。 接 下 来 是 配置 Play 服 务 。 











33.5 配置 Google Play 服务 


要 使 用 Fused Location Provider 获 取 地 理 位 置 ， 就 需要 使 用 Google Play 服务 。 要 让 这 些 服 务 运 
行 起 来 ， 还 需要 一 些 基础 准备 工作 。 

首先 是 添加 Google Play 服务 库 依赖 。 服 务 本 身 是 在 Play 应 用 里 运行 的 ， 但 Google Play 服务 库 
包含 所 有 和 它们 交互 的 代码 。 





























33.5 配置 Google Play 服务 535 





打开 app 模 块 设置 (File 一 Project Structure )。 在 app 模 块 的 dependencies 选 项 页 ， 点 击 + 按 钮 添 
加 库 依 赖 。 添 加 的 时 候 , 要 完整 输入 com.google.android.gms:play-services-location:10.0.1 依 赖 库 名 。 
这 是 Play 服务 的 定位 类 库 。 

随 着 代码 的 迭代 , 这 个 库 的 版 本 号 一 直 在 变 。 如 果 想 知道 最 新 的 版 本 号 , 可 使 用 play-services 
关键 字 搜 索 依赖 库 。 如 果 想 使 用 最 新 版 本 ， 可 使 用 具体 的 版 本 号 指定 要 使 用 的 依赖 库 (play- 
services-location:x.x.x )。 

如 果 有 多 个 版 本 ,到底 该 用 哪个 呢 ? 实践 表明 ,尽量 使 用 最 新 的 。 不 过 , 我 们 无 法 保证 本 章 
代码 一 定 能 与 未 来 版 本 的 依赖 库 兼 容 ， 所 以 ， 学 习 本 章 时 ， 请 使 用 10.0.1 版 本 。 

既然 依赖 的 服务 在 设备 上 的 其 他 应 用 中 和 运行， 就 不 敢 保 证 Play 服务 库 一 定 可 用 。 接 下 来 ， 需 
要 在 代码 中 检测 是 否 有 可 用 的 Play 服务 。 更 新 主 activity 执 行 必要 的 检查 ， 如 代码 清单 33-6 所 示 。 


代码 清单 33-6 检测 Play 服 务 (LocatrActivity.java ) 


public class LocatrActivity extends SingleFragmentActivity { 
private static final int REQUEST ERROR = 0; 


















































@Override 
protected Fragment createFragment() { 
return LocatrFragment.newInstance(); 


} 


@Override 
protected void onResume() { 
super.onResume(); 


GoogleApiAvailability apiAvailability = GoogleApiAvailability.getInstance(); 
int errorCode = apiAvailability.isGooglePlayServicesAvailable(this); 


if (errorCode != ConnectionResult.SUCCESS) { 
Dialog errorDialog = apiAvailability 
.getErrorDialog(errorCode, this, REQUEST_ ERROR, 
new DialogInterface.OnCancelListener() { 


@Override 
public void onCancel (DialogInterface dialog) { 
// Leave if services are unavailable. 
finish(); 
} 
}); 


errorDialog.show(); 


} 
通常 ， 我 们 不 会 像 这 样 使 用 Dialog。 不 过 ， 这 里 LocatrActivity 每 次 启动 后 的 errorCode 
值 都 一 样 ， 所 以 Dialog 都 能 正确 显示 。 
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地 理 位 置 定位 权限 


Locatr 应 用 还 需要 地 理 位 置 定位 权限 才能 工作 。 定 位 相关 的 权限 有 两 个 : android. 
permission.ACCESS FINE LOCATION 和 android.permission.ACCESS_ COARSE LOCATION。 精 
准 定位 来 自 GPS 定位 仪 ; 非 精准 定位 来 自 手机 基站 或 Wi-Fi 接 入 点 。 

Locatr 应 用 需要 精准 定位 数据 ， 所 以 肯定 要 添加 ACC 3 FINE_LOCATION 权 限 。 但 最 好 也 一 
并 把 ACCESS COARSE LOCATION 加 上 ， 因 为 万 一 GPS 没 信号 ， 至 少 还 可 以 尝试 使 用 手机 基站 或 
Wi-Fi 定 位 嘛 。 

Locatr 应 用 需要 搜索 Flickr， 因 此 ， 添 加 完 定位 权限 , 顺手 再 把 网 络 使 用 权限 添加 上 ， 如 代码 
清单 33-7 所 示 。 


代码 清单 33-7 添加 权限 ( AndroidManifest.xml ) 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.bignerdranch.android.locatr" > 














<uses-permission 
android:name="android.permission.ACCESS_FINE LOCATION" /> 
<uses-permission 
android:name="android.permission.ACCESS COARSE LOCATION" /> 
<uses-permission 
android:name="android.permission.INTERNET" /> 


</manifest> 
ep Ls FINE LOCATION 和 COARSE LOCATION 都 属于 危险 型 权限 。 光 在 manifest 


中 配置 还 人 够 安全 ， 你 还 需要 运行 时 请 求 去 用 它们 。 相 关 权 限 使 用 代码 稍 后 会 写 。 现 在 ,我 们 继续 
配置 Google Play 服务 。 




















33.6 ”使 用 Google Play 服务 


要 使 用 Play 服务 ， 还 需要 创建 一 个 客户 端 类 。 这 个 客户 端 是 个 GoogLeApiCLient 类 实例 。 人 
Play 服务 参考 文档 区 ( http://developer.android.com/reference/gms-packages.html )， 可 以 找到 这 个 
(和 其 他 所 有 Play 服务 类 ) 的 使 用 说 明 。 

为 创建 客户 端 ， 先 创建 一 个 GoogteApiCLient .Buitder。 然 后 ,使 用 我 们 要 使 用 的 API 配 置 
它 。 最 后 ， 调 用 buitLd ( ) 方 法 创建 实例 。 

在 onCreate(Bundte) 方 法 中 , 创建 一 个 GoogLeApiCLient .Buitder 实 例 , 然后 , 把 定位 服 
务 API 添 加 给 它 。 如 代码 清单 33-8 所 示 。 


代码 清单 33-8 创建 GoogteApiCLient (LocatrFragment.java ) 


public class LocatrFragment extends Fragment { 
private ImageView mImageView; 
private GoogLeApiCLient mClient; 
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public static LocatrFragment newInstance() { 
return new LocatrFragment(); 


} 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
SetHas0ptionsMenu(true) ; 


mCLient = new GoogLeApiCLient.BuiLder(getActivity()) 
.addApi(LocationServices.API) 
.build(); 
} 
创建 了 mClient 客 户 端 之 后 ,需要 连接 它 。Google 推 荐 在 onStart() 方 法 里 连接 客户 端 ， 在 

onStop() 方 法 里 断 开 连 接 。 调 用 客户 端的 connect() 方 法 会 改变 菜单 按钮 的 行为 ， 所 以 要 调用 
invalidate0ptionsMenu() 方 法 刷新 它 的 状态 ( 稍 后 还 会 再 次 调用 它 : 被 告知 已 连接 的 时 候 。 )， 
如 代码 清单 33-9 所 示 。 


代码 清单 33-9 连接 和 上 断 开 连接 ( LocatrFragment.java ) 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 




















+; 


@Override 
public void onStart() { 
super.onStart(); 


getActivity().invalidateOptionsMenu(); 
mClient.connect(); 


+ 


@Override 
public void onStop() { 
super.onStop(); 


mClient.disconnect(); 


} 


oe | 
public void onCreate0ptionsMenu(Menu menu, MenuInflater inflater) { 


如 果 连 不 上 客户 端 ， 应 用 就 什么 也 做 不 了 。 所 以 ,为 反映 客户 端 连接 状况 ,按钮 的 启用 和 禁 
用 状态 应 作 相 应 切换 ， ee 10 所 示 。 


代码 清单 33-10 ”更 新 菜单 按钮 状态 (LocatrFragment.java ) 


@Override 
public void onCreate0ptionsMenu(Menu menu, MenuInflater inflater) { 
super.onCreateOptionsMenu(menu, inflater); 
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inflater.inflate(R.menu.fragment locatr, menu); 


MenuItem searchItem = menu.findItem(R.id.action locate); 
searchItem.setEnabled(mClient.isConnected()); 


} 

发 现 连 上 客户 端 后 , 再 添加 男 一 个 getActivity().invalidate0ptionsMenu() 调 用 更 新 菜 
单项 ,连接 状态 信息 要 通过 两 个 回调 接口 传递 :ConnectionCallbacks 和 0nConnectionFailed- 
Listener, 在 onCreate (Bundle) 中 , 实现 一 个 ConnectionCaLLbacks 监 听 器 , 如 代码 清单 33-11 
所 示 。 


代码 清单 33-11 ”监听 连接 事件 ( LocatrFragment.java ) 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setHasOptionsMenu (true); 


mClient = new GoogleApiClient.Builder(getActivity()) 
.addApi (LocationServices .API) 
.addConnectionCaLLbacks (new GoogleApiClient.ConnectionCallbacks() { 
@Override 
public void onConnected(Bundle bundle) { 
getActivity().invalidateOptionsMenu(); 
} 


@Override 
public void onConnectionSuspended(int i) { 


} 
}) 
.build(); 


} 

好 奇 的 话 ,， 还 可 以 实现 一 个 0nConnectionFailedListener 监 折 器 , 看 看 会 有 什么 结果 。 当 
然 ， 这 不 是 必须 的 。 

现在 ，Google Play 服务 可 用 了 。 


33.7 ”基于 地 理 位 置 的 Flickr 搜索 


接 下 来 是 实现 基于 地 理 位 置 的 Flickr 搜 索 。 要 完成 这 个 任务 ， 除 了 常规 搜索 功能 外 ， 还 要 附 
加 经 纬度 地 理 位 置信 息 。 
Android 定 位 API 是 在 Location 中 封装 这 些 地 理 位 置信 息 的 。 所 以 ,新 写 一 个 buiLdUrL (...) 
盖 方 法 ， 从 传人 的 Location 对 象 中 取出 地 理 位 置信 息 ， 用 以 创建 我 们 需要 的 搜索 Url， 如 代码 
清单 33-12 所 示 。 


代码 清单 33-12 ”创建 buildUrl(Location) 方 法 (FlickrFetchr.java ) 
private String buiLdUrL(String method, String query) { 
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} 


private String buiLdUrL(Location Location) { 
return ENDPOINT .buiLdUpon() 
.appendQueryParameter("method", SEARCH METHOD) 
.appendQueryParameter("lat", "" + location.getLatitude()) 
.appendQueryParameter("lon", "" + location.getLongitude()) 
.build().toString(); 
} 


然后 ， 再 写 一 个 匹配 的 searchPhotos(Location) 方 法 ， 如 代码 清单 33-13 所 示 。 


代码 清单 33-13 ”创建 searchPhotos(Location) 方 法 (FlickrFetchrjava ) 
public List<GalleryItem> searchPhotos(String query) { 


} 


public List<GalleryItem> searchPhotos(Location location) { 
String url = buildUrl (location); 
return downloadGalleryItems (url); 


33.8 获取 定位 数据 


现在 ,万 事 俱 备 ， 只 缺 地 理 位 置信 息 了 。 有 一 个 类 名 叫 FusedLocationProviderApi， 顾 名 
思 义 ， 要 使 用 Fused Location Provider API 就 全 靠 它 了 。 这 个 类 有 一 个 名 为 FusedLocationApi 的 
实例 ， 它 是 LocationServices 对 象 中 的 一 个 单 例 对 象 。 

要 通过 这 个 API 获 取 地 理 位 置信 息 ， 首 先 要 使 用 LocationRequest 对 象 创建 一 个 定位 请 求 。 编 
写 一 个 findImage() 方 法 创建 并 配置 我 们 需要 的 定位 请 求 ， 如 代码 清单 33-14 所 示 。( 有 两 个 


LocationRequest 类 可 用 ,这 里 要 用 com.google.android.gms.location.LocationRequest 类 ,) 


代码 清单 33-14 ”创建 定位 请 求 ( LocatrFragment.java ) 


@Override 
public void onCreate0ptionsMenu(Menu menu, MenuInflater inflater) { 















































} 


private void findImage() { 
LocationRequest request = LocationRequest.create(); 
request.setPriority(LocationRequest .PRIORITY_HIGH_ACCURACY); 
request.setNumUpdates (1); 
request.setInterval (0); 


} 
有 好 几 个 参数 可 以 配置 LocationRequest 定 位 请 求 对 象 。 
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口 时 间 间 隔 (interval ) : 地 理 位 置 更 新 的 频繁 度 。 
口 更 新 次 数 (number of updates ) : 地 理 位 置 应 该 更 新 多 少 次 。 
口 优先 级 ( priority ) : 是 省 电 优 先 ， 还 是 定位 精准 度 优先 。 
口 失效 ( expiration ) : 定位 请 求 是 否 会 失效 。 如 果 会 ， 什 么 时 候 失 效 。 
口 最 小 位 移 ( smallest displacement ) : 触发 位 置 更 新 ,设备 需 移动 的 最 小 距离 ( 以 米 单位 )。 
默认 创建 的 LocationRequest 定 位 请 求 的 精度 是 街区 级 的 ，, 更 新 也 很 慢 。 所 以 ,通过 修改 优 
先 级 、 更 新 次 数 和 时 间 间 隔 , 我们 可 创建 既 精 准 又 快速 的 定位 请 求 。 为 获取 不 间断 实时 数据 ,我 
们 把 时 间 间 隔 (interval ) 设置 为 0。 

接 下 来 就 是 发 出 定位 请 求 并 从 Location 那 里 监听 反馈 。 这 需要 添加 一 个 LocationListener。 
有 两 个 版 本 的 LocationListener 可 用 ， 这 里 选择 的 是 com.google.android.gms.location. 
LocationListener， 如 代码 清单 33-15 所 示 。 


代码 清单 33-15 ”发 送 定位 请 求 ( LocatrFragment.java ) 


public class LocatrFragment extends Fragment { 
private static final String TAG = "LocatrFragment"; 




















































































































private void findImage() { 
LocationRequest request = LocationRequest.create(); 
request.setPriority(LocationRequest.PRIORITY HIGH ACCURACY); 
request.setNumUpdates (1); 
request.setInterval (0); 
LocationServices.FusedLocationApi 


.requestLocationUpdates (mClient, request, new LocationListener() { 
@Override 


public void onLocationChanged(Location location) { 
Log.i(TAG, "Got a fix: " + location); 
} 
}); 
} 


如 果 定 位 请 求 持续 得 不 到 反馈 ， 那 就 要 和 暂停 新 监听 ， 并 在 合适 的 时 候 调 用 removeLocation - 
Updates(...) 方 法 取消 定位 请 求 。 不 过 ， 既 然 你 使 用 了 setNumUpdates (1) ， 请 求 发 出 后 就 不 
用 管 它 了 。 

( 注意， 调用 requestLocationUpdates (...) 方 法 会 出 错 。 不 要 担心 ， 先 不 管 ， 稍 后 会 处 
理 。) 

最 后 ,编码 让 搜索 按钮 发 出 定位 请 求 。 覆 盖 on0ptionsItemSeLected(. .,) 方 法 并 在 其 中 调 
用 findImage() 方 法 ， 如 代码 清单 33-16 所 示 。 


代码 清单 33-16 关联 使 用 搜索 按钮 ( LocatrFragment.java ) 


@Override 
public void onCreate0ptionsMenu(Menu menu, MenuInflater inflater) { 























} 
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@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.action locate: 
findImage(); 
return true; 
default: 
return super.onOptionsItemSelected (item); 





运行 应 用 并 点 击 搜索 按钮 。 如 图 33-8 所 示 ， 刚 才 忽 略 的 错误 来 捣乱 了 : Locatr 应 用 意外 中 


BA RA 


Locatr has stopped 


CGC openappagain 








图 33-8 ”使 用 权限 遭 拒绝 
查看 Logcat 和 窗口 ， 可 以 看 到 SecurityException 抛 了 出 来 : 


FATAL EXCEPTION: main 33 
Process: com.bignerdranch.android.locatr, PID: 7892 


java.lang.SecurityException: Client must have ACCESS FINE LOCATION permission to 
request PRIORITY HIGH ACCURACY locations. 

at android.os.Parcel.readException(Parcel .java:1684) 

at android.os.Parcel.readException(Parcel .java:1637) 








at com.google.android.gms.location.internal.zzd 
.requestLocationUpdates (Unknown Source) 

at com.bignerdranch.android.Locatr.LocatrFragment 
.findImage(LocatrFragment .java:102) 
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at com.bignerdranch.android.Locatr.LocatrFragment 
.on0ptionsItemSeLected(LocatrFragment .java:89) 
at android.support.v4.app.Fragment.performOptionsItemSelected(Fragment.java:2212) 


at java.lang.reflect.Method.invoke(Native Method ) 

at com.android.internal.os.ZygoteInit$MethodAndArgsCaller 
.run(ZygoteInit.java:886) 

at com.android,.internal.os.ZygoteInit.main(ZygoteInit.java:776) 


看 异常 可 知 ，requestLocationUpdates (...) 方 法 要 能 工作 ， 你 必须 获取 权限 。 


33.9 获取 运行 时 权限 


处 理 运 行 时 权限 需要 做 三 件 习 
口 确认 是 否 拥有 权限 ; 
口 如 果 还 没有 的 话 ; 
监听 权限 请 求 反馈 。 
eg i 应 用 会 显示 标准 系统 权限 获取 界面 。 假 如 跳出 这 样 的 界面 ， 并 明确 告诉 
用 户 ， 应 用 为 什么 要 获取 某 个 权限 ， 接 下 来 就 是 做 完 上 述 三 件 事 。 
但 是 ， 有 时 候 使 用 权限 的 理由 很 难说 清 。 显 然 ， 只 要 搞 不 清 或 觉得 没 必要 ， 用 户 一 般 会 直 
接 拒绝 。 这 种 情况 下 ， 应 用 就 需要 给 个 合理 性 解释 。 这 样 的 话 ， 这 类 应 用 就 需要 再 做 一 件 事 : 
口 确认 是 否 需 给 用 户 个 合理 的 解释 。 
Locatr 应 用 要 使 用 定位 权限 的 理由 不 言 而 喻 ， 所 以 你 不 需要 额外 的 解释 了 。 


令 查 使 用 权限 


首先 我 们 取得 权限 信息 。 打 开 LocatrFragment.java 文 件 ， 添 加 一 个 常量 数组 ， 列 出 应 用 需 
要 的 全 部 权限 ， 如 代码 清单 33-17 所 示 。 


代码 清单 33-17 添加 权限 常量 (LocatrFragment.java ) 


public class LocatrFragment extends Fragment { 
private static final String TAG = "LocatrFragment"; 
private static final String[] LOCATION PERMISSIONS = new String[] { 
Manifest.permission.ACCESS FINE LOCATION, 
Manifest.permission.ACCESS_ COARSE_LOCATION, 
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}; 


private imageView mimageView; 
private GoogleApiClient mClient; 


在 代码 中 使 用 的 全 部 Android 标 准 权限 都 声明 在 Manifest.permission 类 里 。 上 述 常量 数组 列 
出 的 权限 和 AndroidManifest.xml 里 的 是 一 回 事 。 下 一 步 就 是 请 求 使 用 这 些 权 限 。 

权限 安全 类 型 ， 如 dangerous，, 是 赋予 权限 组 而 非 单个 权限 的 。 权 限 组 包含 各 类 具体 的 使 用 权 
限 。 例 如 ，ACCESS FINE LOCATION，ACCESS COARSE LOCATION 都 属于 LOCATION 权 限 组 。 
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表 33-1 日 志 级 别 与 方法 





权 限 组 权 限 

CALENDAR READ CALENDAR, WRITE CALENDAR 

CAMERA CAMERA 

CONTACTS READ_ CONTACTS, WRITE CONTACTS, GET ACCOUNTS 

LOCATION ACCESS_FINE LOCATION, ACCESS COARSE LOCATION 

MICROPHONE RECORD AUDIO 

PHONE READ PHONE STATE, CALL PHONE, READ CALL LOG, WRITE CALL L0G, ADD VOICEMAIL, 
USE_SIP, PROCESS OUTGOING CALLS 

SENSORS BODY_SENSORS 

SMS SEND_SMS, RECEIVE SMS, READ SMS, RECEIVE WAP PUSH, RECEIVE MMS 

STORAGE READ EXTERNAL STORAGE, WRITE EXTERNAL STORAGE 


授予 权限 给 权限 组 内 任何 单一 权限 时 ， 同 组 内 的 其 他 所 有 权限 也 会 获得 授权 。 既 然 应 用 需 
要 的 ACCESS FINE LOCATION 和 ACCESS_ COARSE LOCATION 都 属于 LOCATION 权 限 组 ， 那 只 要 对 
其 中 一 种 权限 操作 就 可 以 了 。 
编写 一 个 私有 方法 ， 确 认 是 否 能 取得 LOCATION_PERMISSIONS 数 组 中 第 一 个 权限 ， 如 代码 
清单 33-18 所 示 。 


























代码 清单 33-18 ”权限 检查 ( LocatrFragment.java ) 


private void findimage() { 


} 


private boolean hasLocationPermission() { 
int result = ContextCompat 
.CcheckSelfPermission(getActivity(), LOCATION PERMISSIONS[0]); 
return result == PackageManager .PERMISSION_ GRANTED; 


} 


checkSeLfPermission( 中 放 尖 丰 Marshmalew 系 守 扣 中 中 于 所 以 ， 这 里 改 用 了 
a pie hel be en . ) 方 法 。 这 样 既 避 免 了 丑陋 的 版 本 判断 代码 ， 又 搞定 
了 兼容 问题 ， 一 举 两 得 啊 。 

接 下 来 ， 在 调用 findImage(...) 方 法 之 前 , 调用 hasLocationPermission() 方 法 确认 拥有 
权限 ， 如 代码 清单 33-19 所 示 。 


代码 清单 33-19 ”添加 权限 检查 ( LocatrFragment.java ) 


GOverride 
public boolean onOptionsitemSelected(Menuitem item) { 
switch (item.getitemid()) { 
case R.id.action locate: 
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if (hasLocationPermission()) { 
findimage(); 
} 
return true; 
default: 
return super.onOptionsitemSelected(item); 


} 
如 果 权 限 检查 不 通过 , 就 调用 requestPermissions(...) 方 法 请 求 授权 ,如 代码 清单 33-20 
所 示 。 


代码 清单 33-20 ”要 求 授权 (LocatrFragment.java ) 


public class LocatrFragment extends Fragment { 
private static final String TAG = "LocatrFragment"; 
private static final String[] LOCATION PERMISSIONS = new String[ ] { 
Manifest.permission.ACCESS FINE LOCATION, 
Manifest.permission.ACCESS COARSE LOCATION, 











}; 
private static final int REQUEST LOCATION PERMISSIONS = 0; 


@Override 
public boolean onOptionsitemSelected(Menuitem item) { 
switch (item.getitemid()) { 
case R.id.action locate: 


if (hasLocationPermission()) { 
findimage(); 
} elsef{ 


requestPermissions (LOCATION_ PERMISSIONS, 
REQUEST_LOCATION_PERMISSIONS ) ; 


} 
return true; 
default: 
return super.onOptionsitemSelected(item); 
} 
requestPermissions(.,..) 是 个 异步 请 求 方 法 。 调 用 它 之 后 ，Android 会 弹出 系统 权限 授 
权 对 话 框 要 求 用 户 反 馈 。 
为 响应 用 户 操 作 ， 我 们 还 要 写 个 onRequestPermissionsResult(...) 响 应 方法 。 用 户 点 
按 ALLOW 或 DENY 按 钮 后 ，Android 就 会 调用 这 个 回调 方法 。 再 次 检查 授权 结果 ， 如 果 用 户 给 
予 授权 ， 就 调用 findImage(...) 方 法 ， 如 代码 清单 33-21 所 示 。 









































代码 清单 33-21 针对 授权 结果 做 出 反馈 ( LocatrFragment.java ) 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 


} 


@Override 
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public void onRequestPermissionsResult(int requestCode, String[] permissions， 
int[] grantResults) { 
switch (requestCode) { 
case REQUEST_ LOCATION_ PERMISSIONS: 
if (hasLocationPermission()) { 
findImage(); 


} 
default: 
super.onRequestPermissionsResult(requestCode, permissions, grantResults); 


} 


private void findimage() { 
LocationRequest request = LocationRequest.create(); 
request,.setPriority(LocationRequest.PRIORITY HIGH ACCURACY); 
request.setNumUpdates (1); 
onRequestPermissionsResult(int，String[ ]，int[ ]) 方 法 有 个 参数 吊 grantResults。 
如 果 愿 意 ， 也 可 以 查看 这 个 参数 值 确认 授权 结果 。 从 上 述 代 码 可 以 看 到 ， 我 们 采用 了 更 方便 方 
式 : 调用 hasLocationPermission() 方 法 时 ， 它 里 面 的 checkSelfPermission(...) 方 法 会 给 出 授 
权 结 # 果 。 所 以 ， 只 要 再 调 一 次 hasLocationPermission() 方 法 就 可 以 了 。 
运行 应 用 并 点 击 搜索 按钮 。 这 次 ， 授 权 对 话 框 跳出 来 了 ， 如 图 33-9 所 示 。 


MA A) 





Allow Locatr to 
access this device's 
location? 


DENY ALLOW 





1HI 





图 33-9 ”授权 对 话 


如 果 你 按 了 ALLOW 按 钮 给 予 授权 ， 除 非 印 载 或 关闭 权限 ， 应 用 会 一 直 拥 有 该 授权 。 如 果 
选 了 拒绝 , 应 用 的 授权 要 求 只 是 暂时 被 否 。 下 次 再 点 按 搜索 按钮 时 , 授权 对 话 框 还 是 会 跳出 来 。 
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(为 方便 调试 ， 建 议 印 载 应 用 彻底 清除 授权 状态 。 不 要 好 奇 为 喻 没 选 关闭 授权 ， 相 比较 而 言 ， 
印 载 应 用 更 简单 。) 

现在 ， 可 以 检查 定位 功能 是 和 否 符合 预期 了 。 如 果 使 用 的 是 模拟 器 ， 不 要 忘 了 先 运行 
MockWalker 应 用 。( 如 有 应 用 菜单 相关 问题 ， 请 参阅 第 13 章 整合 AppCompat 库 解决 。) 运行 应 用 
并 给 予 授权 ， 然 后 查看 日 志 ， 应 该 看 到 以 下 类 似 数 据 : 


.. .D/LibEGL: Loaded /system/lib/egl/libGLESv2 MRVL.so 

...D/GC: <tid=12423> 0ES20 ===> GC Version : GC Ver rls pxa988 KK44 GC13.24 

.. .D/OpenGLRenderer: Enabling debug mode 0 

...I/LocatrFragment: Got a fix: Location[fused 33.758998,-84.331796 acc=38 et=...] 


在 日 志 中 ,可 以 看 到 定位 的 数据 有 经 纬度 、 精 确 度 以 及 定位 时 间 。 在 Googlc 地 图 里 输入 经 
度数 据 ， 就 可 以 看 到 当前 所 处 的 具体 位 置 了 ( 如 图 33-10 所 示 )。 
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33.10 “寻找 并 显示 图 片 


有 了 定位 数据 ， 下 面 来 使 用 它 。 编 写 一 个 异步 任务 找到 当前 地 理 位 置 的 6alleryItem, 下 载 
它 关联 的 图 片 并 显示 出 来 。 
编写 一 个 SearchTask 内 部 类 ， 执 行 搜索 ， 如 果 有 返回 数据 ， 取 出 第 一 个 GalleryItem。 如 
代码 清单 33-22 所 示 


代码 清单 33-22 ”编写 SearchTask 内 部 类 ( LocatrFragment.java ) 


private void findImage() { 
































LocationServices.FusedLocationApi 
.requestLocationUpdates(mClient, request, new LocationListener() { 
@Override 
public void onLocationChanged(Location location) { 
Log.i(TAG, "Got a fix: " + location); 
new SearchTask() .execute(Location) ; 
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}); 
} 


private boolean hasLocationPermission() { 
int result = ContextCompat 


.CheckSelfPermission(getActivity(), LOCATION PERMISSIONS[0]); 
return result == PackageManager.PERMISSION GRANTED; 


} 


private class SearchTask extends AsyncTask<Location,Void,Void> { 


private GalleryItem mGalleryItem; 


@Override 
protected Void doInBackground(Location... 
FlickrFetchr fetchr = new FlickrFetchr(); 
List<GalleryItem> items = 


if (items.size() == 0) { 
return null; 

} 

mGalleryItem = items .get(0); 


return null; 


} 


params) { 


fetchr.searchPhotos (params[0]); 


现在 ,保存 GatleryItem 并 没有 什么 用 处 ,但 下 一 章 会 用 到 它 。 





接 下 来 , 下 载 6alleryItem 关 联 的 图 片 数据 并 解析 出 





图 片 。 然后 , 在 onPostExecute(Void) 





方法 中 ,使 用 mImageView 显 示 图 片 ， 如 代码 清单 33-23 所 示 。 





代码 清单 33-23 下载 并 显示 图 片 ( LocatrFragment.java ) 


private class SearchTask extends AsyncTask<Location,Void,Void> { 


private GalleryItem mGalleryItem; 
private Bitmap mBitmap; 


@Override 

protected Void doInBackground(Location... 
mGalleryItem = items.get(0); 
try { 


params) { 


byte[] bytes = fetchr.getUrLBytes (mGaLLeryItem.getUrL() ) ; 
mBitmap = BitmapFactory.decodeByteArray(bytes，0，bytes,Length ) ; 


} catch (IOException ioe) { 


Log.i(TAG, "Unable to download bitmap" 
} 
return null; 
} 
@Override 


protected void onPostExecute(Void result) { 


，ioe); 
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mImageView.setImageBitmap (mBitmap); 


} 


这 样 ， 就 应 该 能 在 Flickr 上 找到 附近 的 图 片 了 ， 如 图 33-11 所 示 。 启 动 Locatr 应 用 并 点 击 你 的 
位 置 按钮 吧 。 





Locatr 





图 33-11 ”应 用 基本 可 用 了 


33.11 ”挑战 练习 : 权限 使 用 理由 


前 面 说 过 , 很 多 应 用 的 用 户 授 权 对 话 框 给 出 的 权限 请 求 理 由 让 人 费解 。 这 种 情况 下 ， 应 用 
需要 再 给 用 户 个 合理 的 解释 。 

如 何 处 理 权 限 使 用 请 求 ，Android 目 前 的 一 套 流程 是 这 样 的 。 

(1) 如 果 用 户 首次 询问 授权 理由 ， 就 跳出 系统 授权 对 话 框 

(2) 如 果 用 户 问 了 再 问 ， 先 弹出 应 用 授权 解释 对 话 框 ， 然 后 弹出 系统 授权 对 话 框 。 

(3) 如 果 用 户 要 求 永久 性 拒绝 ， 不 显示 任何 授权 对 话 框 。 
怎么 样 ,这 套 流 程 似 乎 有 点 复杂 啊 。 没 事 ， We ActivityCompat ， 
shouldRequestPermissionRationale( 。 在 第 一 次 权限 请 求 之 前 , 这 个 方法 返回 的 结果 是 
false; 在 首次 拒绝 权限 请 求 后 返回 true; ee 

现在 ,请 实施 一 个 权限 使 用 解释 对 话 框 (DialogFragment )， 向 用 户 展示 消息 :“Locatr 使 
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用 定位 数据 寻找 你 附近 发 布 在 Flickr 的 照片 "。 调 用 requestPermissions(...) 方 法 前 ,使 用 
shouldShowRequestPermissionRationale(. .) 方 法 确认 是 否 应 该 显示 权限 使 用 解释 对 话 
框 。 如 果 已 显示 ，Locatr 应 用 应 y 等 用 户 消除 对 话 框 之 后 再 调用 requestPermissions(， , ) 方 法 。 
( 提示: 覆盖 DialogFragment.,onCancel(...) 方 法 可 知道 用 户 何 时 会 消除 权限 使 用 解释 对 话 
框 。) 


33.12 ”挑战 练习 : 进度 指示 器 


点 击 搜索 按钮 后 ，Locatr 应 用 接 下 来 干 了 什么 ， 用 户 一 无 所 知 。 一 个 好 的 应 用 应 该 在 用 户 操 
作 时 立即 给 予 醒 目 反 馈 。 

请 优化 Locatr 应 用 ， 在 用 户 点 击 搜索 按钮 后 ， 立 即 显示 一 个 搜索 进度 条 。 可 使 用 
ProgressDialog 类 来 展示 一 个 旋转 的 进度 指示 。 男 外 ,还 应 跟踪 SearchTask 的 运行 状态 , 在 有 
搜索 结果 返回 时 ， 立 即 清除 状态 指示 。 









































使 用 地 图 











在 本 章 中 ， 我 们 将 继续 完善 LocatrFragment。 除 了 搜索 并 显示 附近 的 图 片 外 ， 还 要 找到 图 
片 的 经 纬度 数据 并 在 地 图 上 标 出 。 


34.1 导入 Play 地 图 服务 库 


继续 学 习 之 前 ， 先 导入 地 图 库 。 这 是 另 一 个 Play 服务 库 。 新 添加 的 依赖 库 名 为 com.googtLe.， 
android.gms:play-services-maps:10.0.1, 输入 时 不 要 搞 错 。 


34.2 Android 上 的 地 图 服务 


能 获取 定位 数据 , 确定 手机 所 处 位 置 已 足以 让 用 户 开 心 了 ; 如 果 数 据 还 能 以 图 形 化 的 方式 直 
观 显 示 ， 那 就 更 好 了 。 地 图 应 用 应 该 是 智能 手机 上 的 首 个 杀手 级 应 用 。 这 也 是 Android 从 一 开始 
就 有 地 图 服务 的 原因 。 

地 图 服务 庞大 繁杂 ， 需 要 大 型 支持 服务 器 系统 来 提供 基础 地 图 数据 。 大 多 数 Android 服 务 或 
应 用 都 能 独立 为 Android 开 源 项 目 ， 唯 独 地 图 不 太 可 能 。 

因此 , 虽然 Android 一 直 内 置地 图 服务 , 但 地 图 API 却 一 直 以 独立 的 Android API 存 在 。 当 前 版 
本 的 Maps v2 API 和 Fused Location Provider 一 起 ， 都 包含 在 Google Play 服务 里 。 所 以 ， 要 使 用 它 ， 
要 么 有 台 安 装 了 Play 商店 应 用 的 设备 ， 要 么 使 用 带 有 Google APIs 的 模拟 器 。 

如 果 你 在 开发 地 图 应 用 , 碰巧 翻 到 本 章 想 看 看 有 什么 可 以 参考 的 ,那么 在 继续 之 前 ,首先 要 
确保 已 做 到 了 这 些 (已 在 上 一 章 完 成 ): 

口 确保 设备 支持 Play 服 务 ; 
口 已 导入 合适 的 Play 服 务 库 ; 
口 确认 设备 安装 上 最 新 版 本 的 Play 商店 应 用 ( 在 代码 里 使 用 GoogleAPIAvailability)。 







































































34.3 获取 Maps API key 


使 用 Maps API 还 需要 在 manifest 文 件 中 声明 你 自己 的 APIkey。 这 个 APIkey 可 以 授权 你 的 应 用 
使 用 Google 地 图 服务 。 
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Google 的 API key 获 取 流 程 一 直 在 变 ， 所 以 ， 具 体 如 何 操作 ， 你 需要 参阅 Google 文 档 
developers.google.com/maps/documentation/android/start。 

撰写 本 书 时 ， 为 获取 API key，Google 要 求 首先 要 创建 一 个 新 项 目 。 没 搞 错 吧 ， 我 们 已 经 有 
了 Locatr 这 个 完整 项 目 。 没事 , 这 难 不 倒 我 们 ,小 小 变通 一 下 就 行 了 。 右键 单 击 com.bignerdranch. 
android.locatr 包 , 选择 NEW 一 Activity 一 Gallery... 菜 单项 ,然后 选择 Google Maps Activity 创 建 一 个 
地 图 activity 模 板 。Activity 使 用 默认 名 称 就 好 了 。 

完成 之 后 ，Locatr 项 目的 manifest 文 件 会 自动 添加 一 些 内 容 ， 同 时 还 会 得 到 
values/google maps_apixml 这 个 新 文件 以 及 一 个 新 的 MapsActivity。 查 看 google maps_apixml 
文件 ， 根 据 其 中 的 指示 取得 一 个 可 用 的 API key。 最 后 ， 在 google maps api.xml 文 件 中 ， 你 的 
google_maps_key 属 性 值 应 该 和 下 面 的 示例 差不多 ， 当 然 key 值 肯定 是 不 一 样 的 啦 。 


<!-- Our Signing key (not yours) --> 
<string name="google maps key" templateMergeStrategy="preserve" translatable="false"> 
AIzaSyClrnnYZExOiYmJkicOK4rdObrXcFkll-U</string> 


注意 ， 刚 才 创 建 的 MapsActivity 是 没 用 的 。 所 以 ， 如 代码 清单 34-1 所 示 ， 从 项 目 里 以 及 
manifest 文 件 里 把 它 删 除 。 


代码 清单 34-1 删除 MapsActivity 声 明 项 ( Androidmanifestxml ) 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.bignerdranch.android.locatr"> 







































































<application ...> 


<meta-data 
android:name="com.google.android.geo.API KEY" 
android:value="@string/google maps_ key"/> 





</application> 


</manifest> 


另外 , 创建 模板 xml 文 件 还 会 自动 引入 com.google.android.gms:play-services 依 赖 库 。 我 们 用 不 
到 这 个 库 ， 而 且 它 还 是 个 巨 无 霸 ， 会 立即 让 Locatr 项 目 超 出 方法 个 数 限制 ， 导 致 项 目 编译 失败 。 
普通 单个 应 用 APK 包 最 多 只 支持 65536 个 方法 。 如 何 突破 这 个 限制 ,已 超出 本 书 讨论 范畴 ， 建 议 
参考 相关 高 级 主题 。) 
如 代码 清单 34-2 所 示 ， 删 除 不 需要 的 依赖 项 。 


代码 清单 34-2 ”删除 Play Services 依 赖 项 ( app/build.gradle ) 
dependencies { 
compile fileTree(include: ['*.jar'], dir: 'libs') 
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', { 
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exclude group: 'com.android,.support', module: 'support-annotations' 


}) 

compile 'com.android.support:appcompat-v7:25.0.1' 

compile 'com.google.android.gms:play-services-location:10.0.1' 
compile 


'com.google.android.gms:play-services-maps:10.0.1' 


testCompile 'junit:junit:4.121 
} 


地 图 API key 搞 定 了 ， 下 面 开始 学 习 创 建 和 使 用 地 图 。 


34.4 创建 地 图 


首先 来 创建 地 图 。 地 图 显示 在 MapView 中 。MapView 的 使 用 和 其 他 视图 类 差不多 ,但 有 一 点 
要 注意 : 你 必须 按 如 下 方式 转发 所 有 的 生命 周期 方法 。 


@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


























mMapView.onCreate(savedInstanceState); 


} 

这 简直 太 麻 烦 了 。 不 过 ， 我 们 可 以 找 MapFragment 帮 忙 ， 或 者 使 用 支持 库 版 SupportMap- 
Fragment, 痛苦 的 事 就 交 给 SDK 去 做 吧 。MapFragment 会 为 我 们 创建 和 托管 MapView， 当 然 还 包 
括 前 面 说 过 的 生命 周期 方法 回调 。 

要 使 用 SupportMapFragment， 首 先 要 废除 原来 的 用 户 界面 。 尽 管 这 听 上 去 像 个 大 工程 ， 实 
际 做 起 来 却 很 简单 。 只 要 改 为 继承 SupportMapFragment 类 ,删除 onCreateView(...) 方 法 , 再 
删除 所 有 使 用 ImageView 的 代码 就 行 了 ， 如 代码 清单 34-3 所 示 。 


代码 清单 34-3 ” 改 用 SupportMapFragment (LocatrFragment.java ) 


public class LocatrFragment extends SupportMapFragment Fragment{ 
private static final String TAG = "LocatrFragment"; 
private static final String[] LOCATION PERMISSIONS = new String[]{ 
Manifest.permission.ACCESS FINE LOCATION, 
Manifest.permission.ACCESS COARSE LOCATION, 












































}; 
private static final int REQUEST LOCATION PERMISSIONS = 0; 


I Vs I a 
private GoogleApiClient mClient; 
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} 

private class SearchTask extends AsyncTask<Location,Void,Void> { 
@Override 
protected void onPostExecute(Void result) { 


mImageView.setImageBitmap (mBitmap}; 
} 


} 


SupportMapFragment 自 己 会 覆 六 onCreateView(...) 方 法 ,改造 任务 就 这 么 完成 了 。 运 行 
Locatr 应 用 ， 可 以 看 到 如 图 34-1 所 示 的 地 图 。 








North 
Atlantic 
Ocean 


Bolowana, Madagascar 


Atlantic 
Ocean South Africa 


Southemn 
Ocean 





图 34-1 一 幅 极 简 地 图 


34.5 ”获取 更 多 地 理 位 置 数据 


为 在 地 图 上 标注 图 片 ， 需 要 知道 图 片 的 地 理 位 置 。 再 给 Flickr API 查 询 串 添加 一 个 extra 参 数 ， 
为 GaLLeryItem 取 回 经 纬度 值 ， 如 代码 清单 34-4 所 示 。 


代码 清单 34-4 ”添加 经 纬度 查询 参数 (FlickrFetchrjava ) 34 


private static final String API _ KEY = "yourApiKeyHere"; 

private static final String FETCH RECENTS METHOD = "flickr.photos.getRecent"; 

private static final String SEARCH METHOD = "flickr.photos.search"; 

private static final Uri ENDPOINT = Uri 
.parse("https://api.flickr.com/services/rest/") 
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.buildUpon() 
.appendQueryParameter("api key", API KEY) 
.appendQueryParameter("format", "json") 
.appendQueryParameter("nojsoncallback", "1") 
.appendQueryParameter("extras", "url s,geo") 
.build(); 











现在 ， 为 GalleryItem 添 加 经 纬度 属性 ， 如 代码 清单 34-5 所 示 。 


代码 清单 34-5 ”添加 经 纬度 属性 ( Galleryltem.java ) 
public class GalleryItem { 


} 





private String mCaption; 
private String mId; 
private String mUrl; 
private double mLat; 
private double mLon; 


public Uri getPhotoPageUri() { 
return Uri.parse("http://www.flickr.com/photos/") 
.buildUpon() 
.appendPath (mOwner) 
.appendPath (mid) 
.build(); 
} 


public double getLat() { 
return mLat; 


} 


public void setLat(double lat) { 
mLat = lat; 
} 


public double getLon() { 
return mLon; 


} 

public void setLon(double lon) { 
mLon = Lon; 

} 

@Override 


public String toString() { 
return mCaption; 


} 





然后 ， 从 返回 的 Flickr JSON 数 据 取出 经 纬度 值 ， 如 代码 清单 34-6 所 示 。 


代码 清单 34-6 ”取出 经 纬度 值 (FlickrFetchrjava ) 
private void parseItems(List<GaLLeryItem> items, JSONObject jsonBody ) 








throws IOException, JSONException { 
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JSONObject photosJsonobject = jsonBody.getJSONObject("photos"); 
JSONArray photoJsonArray = photosJsonObject.getJSONArray("photo"); 


for (int i = 0; i < photoJsonArray.length(); i++) { 
JSONObject photoJsonObject = photoJsonArray.getJSONObject (i); 


GalleryItem item = new GalleryItem(); 
item.setId(photoJjsonObject.getString("id")); 
item.setCaption(photoJsonObject.getString("title")); 


if (!photoJson0bject.has("urL s")) { 
continue; 


} 

item.setUrl(photoJsonObject.getString("url s")); 
item.setOwner(photoJsonObject.getString("owner")); 
item.setLat(photoJsonObject.getDouble("latitude")); 
item.setLon(photoJsonObject.getDouble("longitude")); 
items.add(item); 


} 





搞定 了 图 片 地 理 位 置信 息 ， 接 下 来 在 主 fragment 中 添加 一 些 实例 变量 用 来 保存 搜索 结 








果 : EE 


个 用 于 保存 待 显示 的 Bitmap， 一 个 用 于 GalleryItem， 还 有 一 个 用 于 Location 地 理 位 置 ， 如 代码 





清单 34-7 所 示 。 


代码 清单 34-7 添加 地 图 数据 ( LocatrFragment.java ) 


public class LocatrFragment extends SupportMapFragment { 





private static final int REQUEST LOCATION PERMISSIONS = 0; 
private Bitmap mMapImage; 

private GalleryItem mMapItem; 

private Location mCurrentLocation; 


然后 ， 在 SearchTask 类 中 ,保存 这 些 地 图 数据 ， 如 代码 清单 34-8 所 示 。 
代码 清单 34-8 保存 查询 结果 ( LocatrFragment.java ) 


private class SearchTask extends AsyncTask<Location,Void,Void> { 
private Bitmap mBitmap; 
private GalleryItem mGalleryItem; 
private Location mLocation; 





@Override 

protected Void doInBackground(Location... params) { 
mLocation = params[0]; 
FlickrFetchr fetchr = new FlickrFetchr(); 


} 


@Override 
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protected void onPostExecute(Void result) { 
mMapImage = mBitmap; 
mMapItem = mGalleryItem; 
mCurrentLocation = mLocation; 


} 
至 此 ， 要 用 到 的 地 图 数据 都 有 了 。 接 下 来 的 任务 就 是 在 地 图 上 显示 出 来 。 


34.6 ”使 用 地 图 


SupportMapFragment 会 创建 MapView, 而 MapView 又 会 去 托管 真正 做 事 的 GoogLeMap 。 所 以 ， 
我 们 需要 引用 GoogteMap 对 象 。 调 用 getMapAsync(0nMapReadyCaLLback) 方 法 可 以 获取 到 
GoogleMap 对 象 ， 如 代码 清单 34-9 所 示 。 


代码 清单 34-9 ”获取 GoogleMap (LocatrFragment.java ) 


public class LocatrFragment extends SupportMapFragment { 














private static final int REQUEST LOCATION PERMISSIONS = 0; 


private GoogleApiClient mClient; 
private GoogleMap mMap; 

private Bitmap mMapImage; 

private GalleryItem mMapItem; 
private Location mCurrentLocation; 


@Override 

public void onCreate(Bundle savedInstance9tate) { 
super.onCreate(savedInstanceState); 
setHasOptionsMenu (true); 


mClient = new GoogleApiClient.Builder(getActivity()) 
.build(); 


getMapAsync (new OnMapReadyCallback() { 
@Override 
public void onMapReady (GoogleMap googleMap) { 
mMap = googleMap; 
} 
}); 
} 


顾名思义 ，SupportMapFragment.getMapAsync(...) 方 法 可 以 异步 获取 地 图 对 象 。 如 果 在 
onCreate (Bundle) 方 法 中 调用 这 个 方法 ， 地 图 一 旦 完成 创建 和 初始 化 ， 你 就 能 取 到 它 。 

既然 有 了 GoogLeMap 对 象 ， 根 据 LocatrFragment 的 当前 状态 ， 就 可 以 更 新 地 图 的 展示 了 。 
首先 是 放大 显示 某 个 目标 区 域 。 另 外 ,最 好 在 目标 区 域 周 围 留 出 一 定 间 距 , 所 以 再 添加 一 个 间距 
尺寸 值 ， 如 代码 清单 34-10 所 示 。 
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代码 清单 34-10 ”添加 间距 (res/values/dimens.xml ) 


<resources> 
<!-- Default screen margins, per the Android Design guidelines. --> 
<dimen name="activity horizontal margin">16dp</dimen> 
<dimen name="activity vertical margin">16dp</dimen> 
<dimen name="map_inset margin">100dp</dimen> 
</resources> 


然后 ， 添 加 一 个 updateUI() 方 法 执行 地 图 放大 动作 ， 如 代码 清单 34-11 所 示 。 
代码 清单 34-11 放大 (LocatrFragment.java ) 


private boolean hasLocationPermission() { 


上 


private void updateUI() { 
if (mMap == null || mMapImage == nuLL) { 
return; 


} 


LatLng itemPoint = new LatLng(mMapItem.getLat(), mMapItem.getLon()); 
LatLng myPoint = new LatLng( 
mCurrentLocation.getLatitude(), mCurrentLocation.getLongitude()); 


LatLngBounds bounds = new LatLngBounds.Builder() 
.include(itemPoint) 
.include(myPoint) 
.build(); 


int margin = getResources().getDimensionPixelSize(R.dimen.map_inset margin); 
CameraUpdate update = CameraUpdateFactory .newLatLngBounds (bounds, margin); 
mMap .animateCamera(update) ; 


} 


private class SearchTask extends AsyncTask<Location,Void,Void> { 


下 面 来 详细 解读 上 述 代码 。 为 四 处 移动 boogleMap， 需 要 创建 了 一 个 CameraUpdate 对 象 。 
CameraUpdateFactory 有 好 几 个 静态 方法 可 用 。 通 过 改变 位 置 、 放 大 级 别 以 及 一 些 其 他 属性 ， 
可 以 使 用 这 些 静 态 方法 创建 不 同 的 CameraUpdate 对 象 。 

这 里 ,我 们 创建 了 一 个 指向 特定 LatLngBounds 的 CameraUpdate 对 象 . 可 以 把 LatLngBounds 
看 作 一 个 包围 某 个 坐标 的 矩形 框 。 指定 西南 角 和 东北 角 的 坐标 , 就 能 显 式 地 创建 一 个 LatLngBounds。 
通常 来 讲 ， 提 供 和 矩形 框 包围 的 一 系列 坐标 会 更 容易 些 。LatLngBounds .Builder 可 以 轻松 做 
到 这 一 点 只 要 创建 一 个 LatLngBounds.BuiLder， 然 后 针对 LatLngBounds 要 包围 的 每 一 个 坐标 
调用 .include(LatLng) 方 法 。 最后, 再 调用 buitLd () 方 法 , 就 能 得 到 一 个 配置 好 的 LatLngBounds。 

搞定 了 包围 框 ， 就 看 如 何 缩放 地 图 了 。 有 两 种 方式 可 选 : moveCamera(CameraUpdate) 或 
animateCamera(CameraUpdate)。 以 动画 的 方式 更 有 趣 些 ， 所 以 自然 是 选择 animateCamera 
(CameraUpdate) 方 法 。 
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接 下 来 ,安排 在 两 个 地 方 调用 updateUI() 方 法 : 首次 获得 地 图 时 和 搜索 完成 时 。 如 代码 清 
单 34-12 所 示 。 


代码 清单 34-12 ”调用 updateUI() 方 法 (LocatrFragment.java ) 


@Override 
public void onCreate(Bundle savedInstanceState) { 


getMapAsync (new OnMapReadyCallback() { 
@Override 
public void onMapReady (GoogleMap googleMap) { 
mMap = googleMap; 
updateUI(); 
} 
}); 
} 


private class SearchTask extends AsyncTask<Location,Void,Void> { 


@Override 

protected void onPostExecute(Void result) { 
mMapImage = mBitmap; 
mMapItem = mGalleryItem; 
mCurrentLocation = mLocation; 


updateUI (); 


} 


运行 Locatr 应 用 并 点 击 搜 索 按 钮 。 地 图 应 该 出 现 并 放大 了 包含 你 当前 所 在 位 置 的 一 块 区 域 ， 
如 图 34-2 所 示 。( 模拟 需 用 户 需 要 先 运 行 MockWalker 应 用 。 ) 








Locatr 








图 34-2 ”放大 版 地 图 
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在 地 图 上 绘制 


地 图 看 上 去 真 不 错 ,但 也 仅仅 是 副 地 图 而 已 。 当 前 ,你 肯定 正 处 在 这 幅 地 图 的 某 个 位 置 , Flickr 
图 片 也 是 。 可 是 ， 到 底 在 哪 呢 ? 好 啦 ， 直 接 在 地 图 上 标注 出 来 吧 。 

在 地 图 上 绘制 和 在 普通 视图 上 绘制 是 两 个 概念 , 前 者 相对 更 容易 。 在 普通 视图 上 绘制 是 绘制 
像素 到 屏幕 上 ， 而 地 图 绘制 则 是 在 某 个 地 理 位 置 区 域 添 加 对 象 。 使 用 “绘制 ”这 个 字眼 ,我 们 的 
解读 是 :“ 首 先 创 建 一 些 对 象 ， 然 后 添加 到 GoogteMap 上，GoogleMap 随 后 会 自动 绘制 出 它们 。” 

其 实 上 面 的 说 法 也 不 够 准确 。 事实 上 , 添加 到 GoogLeMap 上 的 对 象 也 是 由 GoogtLeMap 创 建 的 。 
你 创建 的 对 象 是 用 来 告诉 GoogLeMap 你 想 要 创建 什么 的 。 这 是 种 描述 性 对 象 , 又 称 options objects。 

创建 两 个 Marker0ptions 对 象 。 然 后 ， 调 用 mMap .addMarker(Marker0ptions ) 方 法 在 地 图 
上 添加 它们 ， 如 代码 清单 34-13 所 示 。 


代码 清单 34-13 ”地 图 标注 ( LocatrFragment.java ) 
private void updateUI() { 








































































































LatLng itemPoint = new LatLng(mMapItem.getLat(), mMapItem.getLon()); 
LatLng myPoint = new LatLng( 
mCurrentLocation.getLatitude(), mCurrentLocation.getLongitude()); 


BitmapDescriptor itemBitmap = BitmapDescriptorFactory.fromBitmap (mMapImage); 
MarkerOptions itemMarker = new MarkerOptions() 

.position(itemPoint) 

.Icon(itemBitmap) ; 
MarkerOptions myMarker = new MarkerOptions() 

.position(myPoint); 


mMap.clear(); 
mMap.addMarker (itemMarker); 
mMap.addMarker (myMarker); 


LatLngBounds bounds = new LatLngBounds.Builder() 


} 

调用 addMarker(Marker0ptions) 方 法 时 ，GoogleMap 会 创建 Marker 实 例 并 添加 到 地 图 上 。 
如 果 需 要 删除 或 修改 Marker， 应 该 保存 这 个 Marker 实 例 。 每 次 调 updateUI() 方 法 时 ， 都 会 清除 
地 图 ， 所 以 这 里 就 不 需要 保存 它 了 。 

运行 Locatr 应 用 并 点 击 搜索 按钮 。 可 以 看 到 地 图 上 的 两 个 标注 出 现 了 ， 如 图 34-3 所 示 。 
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Locatr 


Druid Hills 





图 34-3” 带 标注 的 地 图 


终于 ，Locatr 应 用 完工 了 。 借 助 这 个 应 用 ， 你 知道 该 如 何 使 用 定位 和 地 图 这 两 个 Play 服务 了 ， 
你 定位 过 手机 位 置 ， ey he services API， 还 学 会 了 地 图 标注 。 闻 苦 了 ,可 以 休 
一 会 儿 了 。 


34.7 深入 学 习 : 团队 开发 和 API key 


团队 合作 开发 使 用 API key 的 应 用 时 ， 管 理 API key 就 会 成 为 一 件 麻 烦 事 。 你 的 签名 凭证 会 保 
存在 你 唯一 拥有 的 密 钥 文件 中 。 团 队 成 员 也 同样 拥有 他 们 自己 的 密 钥 文件 。 每 当 有 新 人 加 入 , 都 
得 找 他 们 要 SHA1， 然 后 更 新 你 自己 的 API key 和 凭证。 
虽然 麻烦 , 但 这 起 码 是 个 可 用 的 APIkey 管 理 办 法 : 在 项 目 中 管理 所 有 的 签名 hash 值 。 如 果 你 
想 借 此 明确 地 控制 团队 成 员 的 开发 行为 ， 这 未 尝 不 是 个 合适 的 办 法 。 

但 是 , 这 里 还 有 另外 一 个 方法 推荐 : 创建 项 目 专用 调试 密 钥 文件 。 这 个 方法 首先 需要 使 用 Java 
的 keytool 创 建 一 个 新 的 调试 密 钥 文件 ， 如 代码 清单 34-14 所 示 。 


代码 清单 34-14 ”创建 新 的 调试 密 钥 文 件 ( 终端) 


$ keytool -genkey -v -keystore debug.keystore -alias androiddebugkey \ 
--Storepass android -keypass android -keyalg RSA -validity 14600 


命令 执行 后 ，keytool 会 抛 出 一 堆 问 题 。 据 实 回 答 即 可 。( 既然 是 调试 key， 除 了 名 字 外 ， 其 
他 都 可 以 使 用 默认 值 。) 
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$ keytool -genkey -v -keystore debug.keystore -alias androiddebugkey \ 
--storepass android -keypass android -keyalg RSA -validity 14600 
What is your first and last name? 

[Unknown]: Bill Phillips 





得 到 了 debug.keystore 文 件 后 ， 把 它 移 到 应 用 模块 目录 。 然 后 ， 打 开 项 目 结构 界面 ， 选 择 app 
模块 ， 再 选择 Signing 选 项 页 。 点 击 + 按 钮 添加 签名 配置 。Name 栏 位 输入 debug，Store File 栏 位 输 
入 debug.keystore， 如 图 34-4 所 示 。 
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图 34-4 配置 debug 签 名 key 


经 过 这 样 的 配置 ， 任 何人 只 要 使 用 同样 的 keystore 文 件 ， 就 能 使 用 同样 的 API key 了 。 是 不 是 
很 方便 呢 ? 

注意 ， 如 果 采 用 这 种 方式 管理 API key， 在 分 发 debug.keystore 时 就 要 当心 了 。 如 果 仅 在 团队 
内 部 分 享 ， 问题 不 大 。 但 千 万 不 要 把 keystore 发 布 到 公共 仓库 。 否则 , 任何 人 都 可 以 使 用 你 的 API 
key 了 。 























material design 








Android 5.0( Lollipop ) 最 大 的 变化 是 引入 了 全 新 的 material design 设 计 风 格 。 这 种 新 的 视觉 设 
计 语 言 一 经 推出 ， 立 即 引 爆 了 设计 界 。 为 方便 学 习 和 开发 ，Google 还 提供 了 详尽 的 设计 指南 。 

当然 , 开发 人 员 一 般 不 怎么 关心 设计 问题 。 他 们 认为 , 设计 素材 是 什么 并 不 重要 ,只 要 在 应 用 
里 用 好 就 行 了 。 然 而 ， 随 着 material design 的 推出 ， 老 观念 或 许 要 改 一 改 了 。 除了 全 新 的 用 户 交 互 概 
念 ，material design 还 要 求 开发 者 具备 一 定 的 设计 人 敏 感性。 一旦 熟悉 ， 应 用 实施 定 能 更 加 得 心 应 手 。 

和 前 面 不 同 , 本 章 可 看 作 本 书 最 大 的 深入 学 习 专 题 。 所 以 ,本 章 不 涉及 实例 开发 ， 而 且 稍 后 
要 介绍 的 大 多 数 内 容 是 可 以 选读 的 。 

对 设计 者 来 说 ，material design 强 调 以 下 三 大 设计 原则 。 

口 实体 隐喻 ( 拟 物 化 ): 应 用 部 件 应 具有 实物 感 。 

口 醒目 、 形 象 、 有 目的 性 : 如 设计 精良 的 杂志 或 图 书 带 来 的 体验 一 样 ， 应 用 设计 元 素 也 应 
有 跃然 纸 上 的 观感 。 

口 动画 要 有 表现 力 : 应 用 应 能 动态 响应 用 户 操 作 。 

醒目 、 形 象 及 有 目的 性 这 条 原则 适用 于 设计 人 员 ， 本 书 不 作 讨论 。 如 果 你 是 个 全 能 型 人 才 ， 
打算 自己 设计 应 用 ， 请 参阅 material design 指 导 手 册 把 握 该 原则 : developerandroid.comy/design/ 
material/index.html。 

就 实体 隐喻 原则 来 讲 , 设计 时 ,如 果 开 发 人 员 能 参与 , 设计 人 员 就 能 创造 出 更 好 的 拟 物 化 界 
面 。 因为 开发 者 知道 如 何 使 用 Z 轴 属性 布置 三 维 界面 , 以 及 如 何 使 用 工具 栏 , 浮动 操作 栏 ( floating 
action bar ) 和 snackbar 这 些 新 的 material 组 件 。 

最 后 是 动画 要 有 表现 力 这 条 原则 ,为 更 好 地 把 握 该 原则 , 你 需要 学 习 一 些 新 的 动画 工具 : state 
list animator 、animated state list drawable ( 是 的 ， 你 没 看 错 ，state list animator 和 animated state list 
drawable 是 不 同 的 工具 )、circular reveal 以 及 shared element transition。 这 些 工 具 能 给 应 用 带 来 许多 
令 人 艳羡 的 视觉 动画 特效 。 













































































35.1 material surface 


作为 开发 人 员 , material design 中 的 material surface 是 要 重点 掌握 的 关键 概念 。 在 设计 者 眼中 ， 
material surface 如 同 1dp 厚 的 纸板 。 这 些 纸板 如 同 真 的 纸 墨 那样 ， 可 以 变 大 ,也 可 以 显示 动画 和 动 
态 文字 ， 如 图 35-1 所 示 。 
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Follow the Big Nerd Way to Nerdvona 
The Big Nerd Ranch we all love traces its origins 
back to 1979, when ties were wide and shoes... 


SHARE LEARN MORE 








For most kids, their first word was mama or 


dada. For us, it was programming. We've been... 


| 





图 35-1 有 两 个 material surface 的 界面 


然而 ， 在 平面 世界 里 ， 如 同 真实 纸张 ， 虚 拟 的 material surface 再 怎么 神奇 ， 它 的 行为 表现 也 


无 法 突破 物理 限制 ,例如 ,一 张 纸 绝 不 可 能 穿 过 男 一 张 纸 , 同 理 , 创造 动画 特效 时 , material surface 
也 要 遵守 这 一 原则 。 





不 过 , 在 三 维 空间 里 ， 就 可 以 自由 摆 放 surface 以 及 让 它们 能 够 互动 。 以 使 用 者 手指 为 参照 对 
象 ，surface 可 以 上 下 移动 ， 靠 近 或 远离 ， 如 图 35-2 所 示 。 








Follow the Big Nerd Woy to Nerdvona 





The Big Nerd Ranch we all love traces its origins 
back to 1979, when ties were wide and shoes... 


| The Big Nerd Ranch we al\ \ove Wraces Ns origins 
\ back \o 1979, when ties were wide and shoes... 
SHARE LEARN MORE 


| SRARE LEARNMORE 











For most kids, their first word was mama or 


| For most Kids, their frst word was mama of 
dada. For us, it was programming. We've been... 


dada. For us, ll was programming. Neve been... 
\ | 
do O 〇 0 


| 
图 35-2 ”三 维 空间 里 的 material design 
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要 制作 一 个 surface 越 过 另 一 个 的 动画 特效 ， 可 直接 向 上 移动 它 ， 然 后 越过 另 一 个 surface ， 如 
图 35-3 所 示 。 


三 Big Nerd Ranch Qo \ 


Follow ihe Big Nerd Hoy Yo Nerdvong 
Follow the Big Nerd Woy to Nerdvana ey 










The Big Nerd Ranch we all love Waces its origins 
The Big Nerd Ranch we all love traces its origins back to 1919, when Wes were wide and shoes... 
back to 1979, when ties were wide and shoes... 


SHARE LEARNMORE 


SHARE LEARN MORE 





For mostWids \heir first word was mama of 
dada.For us, l was programming, We' ve been... 


For most kids, their first word was mama or 
dada. For us, it was programming. We've been... SHARE LEARN MORE 


SHARE LEARN MORE 
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图 35-3 ”surface 越 过 动画 


35.1.1 elevation 和 Z 值 


应 用 界面 元 素 间 的 投影 最 能 让 用 户 准 确 感 知 用 户 界 面 的 深度 。 投 影 该 如 何 绘制 呢 ? 有 些 人 的 
第 一 反应 是 : 这 是 设计 人 员 的 事 , 开发 人 员 直 接 用 就 行 了 。 而 且 认 为 这 是 天 经 地 义 的 事 (不 敢 苟 
同 )。 

稍 加 分 析 可 知 ， 哪 怕 是 简单 的 应 用 ,也 涉及 大 量 的 surface 动 画 特 效 ， 让 设计 者 人 工 绘制 这 样 
千变万化 的 投影 几乎 不 可 能 。 实际 上 ， 只 要 给 每 个 视图 设置 好 elevation，Android 就 可 以 帮 我 们 实 
现 阴影 绘制 。 

随 着 Lollipop 系 统 的 发 布 ，Android 为 布局 系统 引入 了 Z 轴 概念 。 这 允许 我 们 在 三 维 空间 里 布 
置 视图 。 如 图 35-4 所 示 ，elevation 类 似 赋予 布局 视图 的 坐标 : 视图 可 以 动态 远离 其 原始 坐标 ,但 
其 原始 位 置 是 不 变 的 。 








elevation: 2dp 
图 35-4 2Z 平 面 上 的 elevation 


elevation 值 可 以 在 View.setElevation(float) 方 法 或 布局 XML 文 件 中 设置 ， 如 代码 清单 
35-1 所 示 。 
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代码 清单 35-1 在 布局 文件 中 设置 elevation 值 


<Button xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:elevation="2dp"/> 


为 elevation 值 要 作为 Z 基 准 值 使 用 ， 所 以 最 好 采用 设置 XML 属性 值 的 方式 。 而 且 ， 相 上 比 
setELevation(flLoat) 方 法 ， 这 种 方式 更 灵活 ，Lollipop 以 前 版 本 的 系统 会 默认 忽略 
android:etevation 属 性 ， 因 此 ， 难 以 对 付 的 兼容 性 问题 也 就 不 用 考虑 了 。 

要 修改 View 视 图 的 elevation， 可 以 使 用 transtationZz 和 Z 属 性 。 它 们 的 用 法 和 第 32 章 介绍 的 
translationX、translationY、X 和 Y 一 样 。 

如 图 35-5 所 示 ，Z 值 总 是 等 于 elevation 加 上 translationZz。 如 果 给 Z 一 个 值 ， 那 么 系统 会 自 
动 算出 transLationz 值 。 























| 


Z: elevation + translationZ: 6dp 


translationZ 


训 和 i 


‘ 


elevation: 2dp 





图 35-5 Z 和 translationZ 


35.1.2 state list animator 


使 用 material design 的 应 用 通常 包含 许多 用 户 交 互动 画 。 例 如 ， 在 Lollipop 设 备 上 ， 按 住 按钮 
时 ， 按 钮 会 基于 Z 轴 向 用 户 手指 靠近 ， 松 开 时 则 会 后 退 。 

为 方便 实现 这 样 的 动画 特效 ，Lollipop 引 入 了 state list animator。 它 是 state list drawable 的 动态 
版 竞争 对 手 : state list drawable 只 是 在 切换 素材 资源 ( 例如， 点 按 按钮 ， 按 钮 变 灰 )， 而 state list 
animator 能 赋予 视图 动画 特效 。 只 要 在 res/animator 中 定义 一 个 state list animator， 就 能 实现 按钮 浮 
出 的 动画 效果 ， 如 代码 清单 35-2 所 示 。 


代码 清单 35-2 state list animator 使 用 示例 


<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:state pressed="true"> 
<objectAnimator android:propertyName="translationZ" 
android:duration="100" 
android:valueTo="6dp" 
android:valueType="floatType" 
/> 














</item> 
<item android:state pressed="false"> 
<objectAnimator android:propertyName="translationZ" 
android:duration="100" 
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android:valueTo="Qdp" 
android:valueType="floatType" 
人 
</item> 
</selector> 


对 属性 动画 来 说 , 这 非常 有 用 。 假设 想 实施 帧 动画 , 可 以 使 用 另 一 个 动画 工具 : animated state 
list drawable。 

这 个 工具 的 名 字 很 容易 迷惑 人 。 听 起 来 和 state list animator 差 不 多 ， 但 实际 用 法 完全 不 一 样 。 
类 似 于 常规 的 state list drawable， 使 用 animated state list drawable 可 以 为 视图 的 不 同 状态 定义 不 同 
的 图 片 ， 甚 至 能 定义 状态 间 的 帧 动画 转 场 。 

还 记得 吗 ? 第 23 章 的 BeatBox 应 用 的 声音 按钮 是 使 用 state list drawable 定 义 的 。 如 果 你 是 个 设 
计 狂 , 没准 还 想 实 现 每 次 按钮 按 下 时 播放 多 帧 动画 。 没 问题 , 按 代码 清单 35-3 修 改 XML 文 件 就 可 
以 了 。 不 过 , 修改 版 XML 文 件 必 须 放 在 res/drawable-21 目 录 中 ， 因 为 Lollipop 之 前 的 系统 不 支持 这 
个 功能 。 


代码 清单 35-3 ”animated state list drawable 使 用 示例 


<animated-selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/pressed" 
android:drawable="@drawable/button beat box pressed" 
android:state pressed="true"/> 
<item android:id="@+id/released" 
android:drawable="@drawable/button beat box normal" /> 





















































<transition 
android:fromId="@id/released" 
android:toId="@id/pressed"> 
<animation-list> 
<item android:duration="10" android:drawable="@drawable/button frame 1" /> 
<item android:duration="10" android:drawable="@drawable/button frame 2" /> 
<item android:duration="10" android:drawable="@drawable/button frame 3" /> 


</animation-list> 
</transition> 
</animated-selector> 


主意 , 在 上 述 代码 中 ,animated-setector 元 素 里 的 每 个 item 都 有 ID。 在 不 同 的 了 p 间 定义 转 
场 就 可 以 播放 多 帧 动画 。 如 果 还 想 实 现 按钮 释放 动画 ， 那 就 再 添加 一 个 transition 标 签 。 























35.2 ”动画 工具 


material design 引 入 了 很 多 漂亮 的 动画 特效 。 有 些 很 容易 实现 ， 有 些 需要 花 点 力气 。 不 过 , 也 
不 用 担心 ，Android 为 你 准备 了 便利 工具 。 





35.2 动画 工具 567 





35.2.1 circular reveal 


circular reveal 动 画 看 起 来 就 像 墨 滴 在 一 张 纸 上 快 速 扩散 。 从 一 个 交互 点 出 发 (通常 是 用 户 的 
按压 点 )， 视 图 或 是 一 段 文字 向 外 扩散 显现 。 具 体 效 果 如 图 35-6 所 示 。 





























BeatBox BeatBox BeatBox 


65_cjipie 66_indios 67_indios2 65_cjipie 66_indios 67_indios2 


68_indios3 68_indios3 


71_hruuhb 73_houu 71_hruul 


75_jhuee 76_joooaah 75_jhuee 76_joooaah 

















图 35-6 ”在 BeatBox 应 用 中 模拟 circular reveal 动 画 特效 

















还 记得 吗 ? 在 第 6 章 , 为 隐 蕊 按钮 ,我 们 实现 过 这 种 动画 特效 。 这 里 , 我 们 来 看 男 一 个 实现 版 
本 。 与 之 前 相 比 ， 这 个 版 本 的 circular reveal 动 画 特 效 实 现 起 来 繁琐 一 些 。 
要 创建 circular reveal 动 画 特 效 ， 可 调用 ViewAnimationUtils 的 createCircularReveal(...) 
方法 。 该 方法 有 好 几 个 参数 ， 
static Animator createCircularReveal(View view, int centerX, int centeryY， 
float startRadius, float endRadius) 


第 一 个 View 参 数 就 是 要 向 外 扩散 显现 的 视图 。 在 图 35-6 中 ， 这 个 视图 就 是 和 BeatBox- 
Fragment 宽 高 一 致 的 红色 实心 视图 。 如 果 动 画 从 startRadius ( 值 为 0 ) 圆 点 开始 到 endRadius 
结束 ， 这 个 红 点 视图 会 先 变 为 透明 状态 ， 然 后 随 着 一 个 不 断 放 大 的 圆 慢 慢 显现 。centerX 和 
centerY 是 这 个 圆 的 圆 点 坐标 (也 就 是 View 的 坐标 )。 该 方法 会 返回 一 个 Animator ( 和 第 32 章 用 
过 的 Animator 一 样 )。 

material design 指 南 指 出 ，circularreveal 动 画 应 该 开始 于 用 户 手指 在 屏幕 上 的 触 点 。 所 以 , 首 
先 要 找到 用 户 点 击 视图 的 坐标 ， 如 代码 清单 35-4 所 示 。 


代码 清单 35-4 ”找到 视图 点 击 坐 标 


@Override 
public void onClick(View clickSource) { 
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int[] clickCoords = new int[2]; 


// Find the location of clickSource on the screen 
clickSource.getLocationOnScreen(clickCoords); 


// Tweak that location so that it points at the center of the view, 
// not the corner 

clickCoords[0] += clickSource.getWidth() / 2; 

clickCoords[1] += clickSource.getHeight() / 2; 


performRevealAnimation(mViewToReveal, clickCoords[0], clickCoords[1]); 


然后 开始 执行 circular reveal 动 画 ， 如 代码 清单 35-5 所 示 。 
代码 清单 35-5 ”创建 并 执行 circular reveal 动 画 


private void performRevealAnimation(View view, int screenCenterX, int screenCenterY) { 





// Find the center relative to the view that will be animated 
int[] animatingViewCoords = new int[2]; 
view.getLocationOnScreen(animatingViewCoords); 

int centerX = screenCenterX - animatingViewCoords[0]; 

int centerY = screenCenterY - animatingViewCoords[1]; 


// Find the maximum radius 

Point size = new Point(); 
getActivity().getwindowManager().getDefaultDisplay().getSize(size); 
int maxRadius = size.y; 


if (Build.VERSION.SDK INT >= Build.VERSION CODES.LOLLIPOP) { 
ViewAnimationUtils.createCircularReveal(view, centerX, centerY, 0, maxRadius) 
.Start(); 








主意 ， 成 功 调用 createCircularReveal(...) 方 法 有 个 前 提 条 件 : 布局 中 已 有 目标 视图 。 


35.2.2 





shared element transition 

















shared element transition( 又 称 为 hero transition ) 是 material design 中 引入 的 另 一 新 动画 特效 。 
它 适 用 于 一 种 特殊 场景 : 两 个 视图 显示 相同 元 素 。 
前 面 , 在 CriminalIntent 应 用 中 ，crime 记 录 的 明细 界面 会 显示 一 张 缩 略 图 。 当 时 ,有 个 挑战 练 























习 要 求 阐 























LE 出 一 个 新 视图 展示 全 尺寸 照片 。 假 如 做 过 的 话 ， 你 应 还 有 印象 ,完成 后 的 效果 图 差不多 








如 图 35-7 所 示 。 

















这 是 一 种 常见 的 交互 模式 : 点 击 一 个 元 素 ， 弹 出 新 的 视图 显示 元 素 明细 。 
对 于 两 个 展示 相同 元 素 的 视图 ， 其 间 的 任何 切换 动画 都 可 以 用 shared element transition 实 现 。 





























图 35-7 中 ， 右 边 的 大 图 片 和 左边 的 小 图 片 是 同一 张 图 。 所 谓 相同 元 素 就 是 指 这 张 图 。 它 实际 就 是 


个 共享 元 素 ( shared element )。 
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€ Criminalintent 


B TITLE 
Pickles and peanuts 


DETAILS 
THU FEB 12 22:10:36 GMT+00:00 2015 
口 soved 


FRANK HANKLES 


SEND CRIME REPORT 





图 35-7 ”放大 版 照片 视图 


自 Lollipop 开 始 ，Android 终 于 有 办 法 实现 activity 或 fragment 间 的 转 场 动画 了 。 图 35-8 是 动画 
过 程 中 的 一 幅 截 图 ， 可 大 致 看 出 实现 效果 。 下 面 学 习 如 何 把 它 应 用 于 activity。 

















图 35-8 ”shared element 的 变换 


实现 activity 间 的 转 场 动画 涉及 以 下 三 个 步骤 。 

(1) 打开 activity transition。 

(2) 为 每 个 shared element 视 图 设置 transition 名 称 。 

(3) 启动 带 Activity0ptions (触发 动画 ) 的 另 一 个 activity。 
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首先 是 打开 activity transition。 如 果 你 的 activity 使 用 了 AppCompat 主 题 ,， 这 个 步骤 可 以 直接 跳 
过 。( AppCompat 继 承 Material 主 题 ， activity transition 已 打开 。 ) 

在 CriminalIntent 的 例子 中 , 为 了 让 日 标 activity 拥 有 透明 背景 ， 我 们 使 用 了 @android: style/ 
Theme.TransLucent.NoTitLeBar 主 题 样式 。 这 个 主题 没有 继承 Material 主 题 ， 所 以 需要 手工 打 
开 activity transition。 有 两 种 方式 可 以 打开 activity transition， 先 来 看 如 何 用 代码 打开 它 ， 如 代码 清 
单 35-6 所 示 。 


代码 清单 35-6 ”以 代码 的 方式 打开 activity transition 


@Override 

public void onCreate(Bundle savedInstanceState) { 
getWindow().requestFeature(Window.FEATURE ACTIVITY TRANSITIONS); 
super.onCreate(savedInstanceState); 








} 


另外 一 种 方式 是 修改 activity 使 用 的 样式 , 设置 android:windowActivityTransitions 属 性 
值 为 true， 如 代码 清单 35-7 所 示 。 


代码 清单 35-7 在 样式 里 打开 activity transition 


<resources> 
<style name="TransparentTheme" 
parent="@android:style/Theme.Translucent.NoTitleBar"> 
<item name="android:windowActivityTransitions">true</item> 
</style> 




















</resources> 


来 看 如 何 为 shared element 视 图 设置 transition 名 称 。Android 在 API 21 中 为 View 引 入 了 
transitionName 属 性 。 所 以 ， 可 以 在 布局 或 代码 中 设置 这 个 属性 值 。 具 体 用 哪 种 方式 ， 要 看 当 
时 的 场景 。 本 例 中 ， 我 们 在 布局 XML 文件 里 ， 将 android:transitionName 属 性 设置 为 image， 
如 图 35-9 所 示 。 





























FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android:background="#77000000" 


ImageView 
android: layout_gravity="center" 


android:transitionName="image" 
android:id="@+id/image_view" 
android: layout_width="380dp" 
android: layout_height="300dp" 











图 35-9 ”设置 android:transitionName 属 性 值 为 jmage 
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然后 ， 再 定义 一 个 startWithTransition(..,) 静 态 方 法 ， 为 另 一 视图 设置 相同 的 transition 
名 ， 如 代码 清单 35-8 所 示 。 


代码 清单 35-8 ”定义 startwithTransition(...) 方 法 


public static void startWithTransition(Activity activity, Intent intent, 
View sourceView) { 
ViewCompat.setTransitionName (sourceView, "image"); 
ActivityOptionsCompat options = ActivityOptionsCompat 
.makeSceneTransitionAnimation(activity, sourceView, "image"); 





activity.startActivity(intent, options.toBundle()); 
= 


Android 旧 版 本 系统 中 ,View 视 图 没有 setTransitionName (String) 属 性 方法 。 所 以 , 需要 
使 用 ViewCompat .setTransitionName(View，String) 方 法 。 
在 代码 清单 35-8 中 ,作为 三 个 步骤 的 最 后 一 步 ， 我 们 创建 了 Activity0ptions 对 象 , 让 它 告 
诉 操作 系统 ， 共 享 元 素 ( shared element ) 是 哪个 ， 使 用 什么 transitionName 值 。 
transition 和 shared element transition 还 有 其 他 用 途 。 例 如 ， 它 们 还 可 以 用 于 fragment 间 的 转 场 
动画 。 欲 了 解 更 多 ， 请 阅读 Google 的 transition 框 架 文档 : https://developer.android.com/training/ 
transitions/overview.html。 


35.3 ”新 的 视图 组 件 


material design 指 南 还 设计 了 一 些 全 新 视图 组 件 , 它们 在 Lollipop 系 统 中 尚 属 首 秀 。Android 设 
计 团 队 已 实现 了 一 些 。 下 面 就 一 起 来 学 习 一 下 ， 没 准 哪 天 就 要 用 到 。 


35.3.1 card 


首先 学 习 的 是 card 这 个 新 组 件 ， 如 图 35-10 所 示 。 它 是 个 frame 容 右 组 件 。 
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图 35-10 ”card 组件 
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card 容 器 组 件 用 来 装载 其 他 内 容 。 从 图 35-10 可 以 看 出 ， 它 的 边 角 有 点 圆 ， 微 微 浮 出 底 平面 ， 
在 身后 投下 了 一 圈 阴 影 。 

设计 问题 已 超出 本 书 讨论 范畴 ,所 以 , 什么 时 候 、 什 么 地 方 该 用 card,， 我 们 给 不 了 建议 。( 想 
知道 的 话 ， 可 以 查阅 Google 的 material design 文 档 : http:/www.google.com/design/spec。) 我 们 只 能 
教 你 创建 它 : 使 用 CardView。 

类 似 RecyclerView，CardView 是 com.android.support:cardview-v7 支 持 库 中 的 一 个 视图 类 。 
使 用 前 ， 首 先 要 在 项 目 中 添加 这 个 依赖 。 

引入 以 后 ， 就 可 以 像 使 用 布局 中 的 ViewGroup 一 样 使 用 CardView 了 ， 如 代码 清单 35-9 所 示 。 
CardView 是 个 FrameLayout 子 类 ， 所 以 FrameLayout 的 任何 布局 参数 它 都 可 以 用 。 


代码 清单 35-9 ”在 布局 中 使 用 CardView 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:Layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" 
tools:context=" .MainActivity"> 
<android.support.v7.widget.CardView 

android:id="@+id/item" 

android:layout width="match parent" 

android:layout height="200dp" 

android:layout margin="16dp" 

> 



































</android.support.v7.widget.CardView> 


</LinearLayout> 


既然 是 支持 库 类 ， 自 然 能 较 好 地 兼容 旧 设 备 。 和 其 他 组 件 不 一 样 ，CardView 总 带 投影 效果 。 
(不 过 ,在 旧 设 备 上 ， 它 只 绘制 自己 ,投影 效果 不 明显 。) 感 兴趣 的 话 ， 可 以 查阅 CardView 文 档 ， 
看 看 在 新 旧 设 备 上 还 有 哪些 视觉 差异 。 




















35.3.2 floating action button 





男 一 个 常见 组 件 是 floating action button ( FAB )， 如 图 35-11 所 示 。 

floating action button 是 在 Google 设 计 支 持 库 中 实现 的 。 同 样 ， 使 用 前 ， 首 先 要 在 项 目 中 引入 
com.android.support:design:24.2.1 这 个 依赖 。 

floating action button 可 以 看 作 是 由 一 个 实心 圆 和 一 个 0utLineProvider 提 供 的 圆 形 投影 组 
成 。 作 为 InageView 子 类 , FloatingActionButton 类 负责 生成 实心 加 和 阴影 。 创建 floating action 
button 很 简单 : 在 布局 文件 中 放 入 FloatingActionButton, 并 设置 它 的 src 属 性 指向 要 显示 在 按 
钮 上 的 图 片 。 


























35.3 ”新 的 视图 组 件 573 





MY 





图 35-11 一 个 floating action button 


如 果 把 floating action button 放 在 Framelayout 中 ， 设计 支持 库 还 会 引入 一 个 比较 智能 的 
CoordinatorLayout。 这 个 FrameLayout 子 类 布局 会 随 其 他 控件 的 移动 调整 floating action button 
的 位 置 。 这 样 , 如 果 要 展示 一 个 Snackbar ( 稍 后 介绍 ) ， FAB 会 自动 上 移 以 避免 被 Snackbar 挡 住 。 
具体 实现 如 代码 清单 3$-10 所 示 。 


代码 清单 35-10 布局 floating action button 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 
[... main content here ...] 
<android,.support.design.widget.FloatingActionButton 
android:id="@+id/floating action button" 
android:layout width="wrap _ content" 
android:layout height="wrap content" 
android:layout gravity="bottom|right" 
android:layout margin="16dp" 
android:src="@drawable/play"/> 
</android.support.design.widget.CoordinatorLayout> 


上 面 这 段 代码 会 把 按钮 放 在 右 下 角 位 置 的 其 他 内 容 之 上 ， 互 不 干扰 。 


35.3.3 snackbar 35 


snackbar 比 floating action button 复 杂 一 些 。 它 位 于 屏幕 底部 , 是 一 种 不 怎么 需要 用 户 交 互 的 控 
件 ， 如 图 35-12 所 示 。 
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图 35-12 ”一 个 snackbar 控 件 


snackbar 控 件 的 动画 效果 是 从 屏幕 底部 问 上 弹出 。 短 暂停 留 一 会 ， 或 是 屏幕 上 有 了 其 他 交互 
操作 ， 它 就 会 自动 退出 。 snackbar 的 作用 和 Toast 类 似 。 不 同 的 是 ， < 身 就 是 应 用 界面 的 
一 部 分 ; 而 Toast 会 出 现在 应 用 界面 之 上 ， 一 动不动 ， 即 使 用 户 已 导航 至 其 他 页 面 。 此 外 ， 为 方 
便 用 户 快速 操作 ，snackbar 上 还 允许 放置 按钮 。 

和 floating action button 一 样 ，snackbar 也 是 在 Android 设 计 支 持 库 中 实现 的 。 

创建 和 显示 snackbar 的 方式 和 Toast 类 似 ， 如 代码 清单 35-11 所 示 。 


代码 清单 35-11 创建 并 显示 snackbar 


Snackbar.make(container, R.string.munch, Snackbar.LENGTH SHORT).show!(); 


创建 Snackbar 需 要 传人 放置 它 的 视图 、 要 显示 的 文字 以 及 它 暂 留 的 时 间 。 最 后 , 调用 show() 
方法 展示 它 。 

针对 某 些 破坏 性 操作 ， 可 以 在 snackbar 控 件 右 端 配置 应 急 操 作 按 钮 ， 比 如 undo。 万 一 用 户 不 
小 心 犯 了 错 ， 比 如 删除 了 一 条 crime 记 录 ， 就 可 以 立即 借助 它 执行 反 删 除 。 














































































































35.4 深入 学 习 material design 


本 章 介 绍 了 一 大 堆 有 趣 实用 的 新 工具 。 不 过 ,工具 不 是 摆设 ,不 要 放 那 里 吃 灰 ， 有 机 会 就 要 
用 起 来 。 所 以 ， 开 发 人 员 平 时 要 多 多 留心 ， 积 极 研究 如 何 使 用 这 些 全 新 工具 和 动画 特效 。 

Android 提 供 有 material design 规 格 说 明 书 ( www.google.com/design/spec/material-design/ 
introduction.html ), 它 里 面 满 是 精彩 的 点 子 , 可 以 帮助 激发 设计 灵感 。 当 然 , 也 可 以 从 Google Play 
下 载 精品 应 用 ,看 看 别人 是 怎么 应 用 material design 的 ,再 问 问 自己 :怎么 用 在 我 自己 的 应 用 里 呢 ? 
相信 自己 ， 一 番 努 力 后 ， 你 肯定 能 做 出 超越 精品 的 好 应 用 。 










































































恭喜 你 完成 本 书 的 学 习 ! 这 很 了 不 起 ， 不 是 人 人 都 能 做 到 的 。 现 在 就 去 入 赏 一 下 自己 吧 
总 之 ， 和 干洗 万 兰 终 有 回报 : 你 已 经 是 一 名 合格 的 Android 开 发 者 了 。 


36.1 终极 挑战 


最 后 ， 请 再 接受 一 个 挑战 : 成 为 一 名 优秀 的 Android 开 发 人 员 。 成 为 优秀 的 开发 者 ， 可 以 说 

是 千 人 千 途 。 每 个 人 都 应 去 找寻 最 适合 自己 的 路 。 

那么 ， 路 在 何方 ? 对 此 ， 我 们 有 一 些 建议 。 

口 编写 代码 。 现 在 就 开始 。 如 不 加 以 实践 ， 很 快 就 会 忘记 所 学 知识 。 参 与 开发 一 些 项 目 ， 

或 者 自己 写 个 简单 应 用 。 无 论 怎 样 ， 不 要 浪费 时 间 ， 利 用 一 切 机 会 编写 代码 。 

口 持续 学 习 。 读 完 本 书 ， 你 已 经 掌握 了 Android 开 发 领域 的 很 多 知识 。 你 有 灵感 了 吗 ? 利用 
所 学 知识 ， 可 尝试 开发 一 些 自己 感 兴 趣 的 应 用 。 开 发 时 ， 如 遇 到 问题 ， 记 得 经 常 查阅 文 
档 ， 或 阅读 更 高 级 主题 的 图 书 。 另 外 ， 也 可 收看 YouTube 的 Android 开 发 者 频道 ， 或 收听 
Google 的 Android 开 发 者 播客 ( Android Developers Backstage podcast )。 

口 参与 技术 交流 。 参 与 本 地 技术 交流 大 会 ， 多 认识 些 乐 于 助人 的 开发 者 。 参 与 Android 开 发 
者 大 会 ， 与 其 他 Android 开 发 人 员 ( 包括 我 们 ) 面对面 交流 。 另 外 ， 还 可 以 关注 一 些 活 跃 
在 Twitter 和 Google Plus 上 的 开发 高 手 。 

口 探索 开源 社区 。 登 录 www.github.com， 上 面 有 海量 的 Android 开 发 资源 。 找 找 那 些 很 酷 的 
共享 库 ， 顺 便 看 看 共享 者 贡献 的 其 他 项 目 资源 。 同 时 ， 也 请 积极 共享 自己 的 代码 ， 如 果 
能 帮 到 别人 ， 那 最 好 不 过 了 。 男 外 ， 也 可 以 订阅 Android 每 周 邮件 列表 ， 及 时 跟踪 了 解 
Android 开 发 社区 新 动向 ( http://androidweekly.net/ )。 


36.2 ”关于 我 们 


来 Twitter 找 我 们 吧 ! Bi 好 、Chris 和 Kristin 的 帐号 分 别 是 @billjings、@cstew 和 @kristinmars。 
有 兴趣 的 话 , 也 可 以 访问 http:/www.bignerdranch.comybooks , 看 看 我 们 的 其 他 指导 书 。 同 时 ， 
我 们 还 为 开发 者 提供 课时 一 周 的 各 类 培训 课程 ,可 保证 在 一 周 内 轻松 学 完 。 当 然 ， 如 果 有 高 质量 
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代码 开发 需求 , 我 们 也 可 以 提供 合同 开发 。 欲 详细 了 解 , 请 访问 网 站 http:/www.bignerdranch. com。 


36.3 ”致谢 
没有 读者 ， 我 们 的 工作 将 毫 无 意义 。 感 谢 所 有 购买 并 阅读 本 书 的 读者 ! 


权威 一 源 自 大 名 易 昂 的 Big Nerd Ranch 训 练 营 培 训 讲义 ， 该 训练 营 已 经 为 微软 、Google、 
Facebook 等 行业 巨头 培养 了 众多 专业 人 才 。 
全 面 一 一 涵盖 Android 开 发 所 有 必 备 理论 概念 和 技术 知识 点 ， 从 Android 4.4 到 Android 7.0 都 适用 。 


实用 一 一 8 个 Android 应 用 开发 实战 项 目 ， 传 授 一 线 开 发 经 验 。 
易 懂 一 -以 循序 渐进 的 方式 精心 编排 章节 ， 一 步 一 步 写 出 Android 应 用 。 
时 新 一 一 在 前 两 版 的 基础 上 ， 新 增 数 据 绑 定 、MVVM 架 构 、Android 辅 助 功能 等 内 容 。 








“在 阅读 本 书 之 前 ， 我 跟着 一 些 Android 开 发 教程 自学 ， 却 发 现 困难 重重 。 本 书 用 简单 易 懂 的 示 
例 帮 助 我 轻松 上 手 ， 并 让 我 对 Android 开 发 有 了 更 好 的 整体 认识 。” 
一 一 Amazon 读者 


“Android 技 术 更 新 得 太 快 了 。 每 次 拿 起 讲 Android 的 书 ， 我 都 担心 自己 在 学 快 过 时 的 内 容 。 
但 这 本 书 不 一 样 ， 我 想 学 的 都 在 书 中 。 此 外 ， 我 还 想 给 书 中 的 流程 图 点 赞 ， 它 们 使 星 涩 的 概念 变 
得 十 分 清晰 。” 
一 一 Amazon 读 者 
“对 于 我 们 来 说 ， 这 是 一 本 非常 全 面 的 培训 教材 。 它 已 使 我 们 公司 数 百 名 工程 师 掌 握 了 构建 
Android 应 用 的 诀 穿 。 另 外 ， 对 想 要 提升 Android 开 发 技能 的 人 ， 这 本 书 同 样 也 有 很 大 帮助 。- 
Mike Shaver，Facebook 通 信 工 程 主管 


“不 管 你 是 刚刚 迈进 Android 开 发 的 大 门 ， 还 是 准备 掌握 更 多 高 级 开发 技术 ， 本 书 都 非常 值得 
看 。 其 完整 的 内 容 体系 、 清 晰 的 组 织 结构 以 及 轻松 的 讲述 风格 ， 都 让 人 过 目 不 忘 。” 
一 一 James Steele，《Android 开 发 秘籍 》 作 者 
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